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SUBJECT 


Description of and User Procedures for System Service Macro Calls, Device 
Drivers, and Data Structures 


SPECIAL INSTRUCTIONS 


This revision supersedes Revision 1 of the manual dated July 1978. Appendix B 
was deleted and succeeding appendixes renumbered. Except for revised Section 6, 
new Section 8, and revised Appendixes A and C, change bars indicate new or 
changed information, asterisks denote deletions. Major additions are macro 
calls for MOD 600 software. 


SOFTWARE SUPPORTED 


This manual supports the Series 60 (Level 6) GCOS 6 MOD 400 (Release 0120) 
and MOD 600 (Release 0100) Operating Systems. See the manual directory of 
the latest MOD 400 System Concepts (Order No. CB20) or MOD 600 System 
Concepts (Order No. CB50) manual for information as to later releases supported 
by this manual. 


PREREQUISITE INFORMATION 


MOD 400 System Concepts manual or MOD 600 System Concepts manual and 
GCOS 6 Assembly Language Reference manual. 


ORDER NUMBER 
CBO8, Rev. 2 December 1978 


Honeywell 


PREFACE 


This manual is for assembly language programmers who use the 
GCOS system service macro routines and macro calls in writing 
application programs. The manual describes the macro calls for 
monitor services, for using the file system, and for generating 
data structures. 


The manual also discusses Honeywell peripheral device 
drivers. 


Section 1 concerns macro call syntax, register conventions, 
and addressing conventions. 


Sections 2, 3, and 4 briefly summarize and list macro calls 
for monitor services, for the file system, and for defining data 
structures, respectively. 


Section 5 describes in detail the use, structure, function, 
and error return codes for each macro routine and macro call, 
some with examples. These descriptions are arranged alphabet- 
ically by function description name, according to the function 
description shown in column 2 of Table 1-l. 


Section 6 describes the GCOS 6 Honeywell device drivers for 
data transfer in system and applications programs with Level 6 
peripheral devices. 


Sections 7 and 8 discuss trap handling for hardware and 
software traps under MOD 400 and MOD 600, respectively. 


Appendix A describes various block data structures that are 
related to certain macro routines. Appendix B summarizes 
register contents before and after execution of the system 
service macro calls. Appendix C shows the ASCII and EBCDIC 
Character sets. 


(c) Honeywell Information Systems Inc., 1979 File No.: 1823 
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LOCATION OF MACRO ROUTINES 


The macro routines are located either on cartridge disk or 
on mass storage unit in a library named >LDD>MACRO>EXEC LIB. 
diskette they are located in AZSYS0O2>LDD>MACRO>E XEC LIB. 


Macro 
Call Name 
(1) 


SABGRP 
SABGRO 


SACTCL” 
SACTD1° 


SACTD2° 


SACTID 


SACTOP? 
SACTRI1” 
SACTR2” 


SACTVG 


SACTVT 
SACTW1- 


b 
SAC TW 2 


SACUPD” 


SASFIL 


Table l-l. 
Function Description 
(2) 


Abort group 


Abort group request 


Accounting files, close 
Accounting raw record, delete 


Accounting update record, 
delete 


Account identification 


Accounting files, open 
Accounting raw record, read 


Accounting update record, read 


Activate group 


Activate task 
Accounting raw record, write 


Accounting update record, 
write 


Accounting field, update 


Associate file 


System Service Macro Calls 


Function 
Group 


Task group 
control 


Task group 
control 


Accounting 
Accounting 


Accounting 


Identifica- 


tion and 


information 


Accounting 
Accounting 
Accounting 


Task group 
control 


On 


Task control 


Accounting 


Accounting 


Accounting 


File manage- 


ment 


7/79 


CBO08-02A 


Macro 
Call Name 


(1) 


SCLFIL 


SCLPNT 


SCLRSW 


SCMDLN 


SCMSUP 


SCNCRQ 


SCNSRQ° 


SCRB 


|SCRDIR 


Table 1-1 (cont). 


Function Description 


(2) 


Bound unit, attach 
Bound unit, detach 

Bound unit identification 
load 


Bound unit, 


Terminate user session 


Cancel request 
Command in (read command- 
in file) 


Close file 


Clean point 


Clear external switches 


process 


Command line, 


Console message Suppression 


Cancel clock request 


Cancel semaphore request 


Clock request block 


Clock request block offsets 


Create directory 


Function 
Code 


(3) 


1055-105 


0C13 


OB02 


0C08 


0902/0903) 
| interface 


0501 


0601 


System Service Macro Calls yo~™ 


Se a - 3 
bee 


Function 


Group 
(4) 


Task control 
Task control 
Identifica- 


tion and 
information 


' Task control 


Task group 
control 


Task control 
Standard 
system file 


1/0 


File manage- 
ment 


Task control 


External 
switch 


Task control 


Operator 


| Clock 


Semaphore 
handling 


Data struc- 
ture genera- 
tion 


Data struc- 
ture genera- 
tion 


File manage- és 
ment Ma” 


CB08 


Table 1-1 (cont). System Service Macro Calls 


Function 
Function Description Code Group 


Macro Function 
Call Name | 


(1) 


(2) 


(3 ) 


(4) 


SCRFIL Create file 1030 File manage- 
ment 
SCRGRP Create group OD03 Task group 
control 
SCRKDB Create file, key - Data structure 
descriptor block offsets generation 
b 
SCRMSG Create maximum segment OCOE Task control 
SCROAT Create overlay area table 070A Overlay 
handling 
SCRPSB Create file parameter - Data struc- 
Structure block - offsets ture genera- 
tion 
SCRSEG” Create segment OCcOC Task control 
SCRTSK Create task 0C02/0C03| Task control 
b. 
SCSGRP * | Create system group OD02 Task group 
control 
SCUSID”® Change user identification ODOE Task group 
control 
SCWDIR Change working directory 10B0 File manage- 
ment 
SDFSM Define semaphore 0604 Semaphore 
handling 
SDLDIR Delete directory 10A5 File 
Management 
SDLFIL Delete file 1035 File 
management 
| SDLGRP Delete group OD04 Task group 
control 
| SDLREC | Delete record 1130/1131| Data manage- 
| | ment 
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Macro 


Call Name 


(1) 


SDLOAT 


SDLSEG? 


SDLSM 


SDLTSK 
SDSDV 


SDSFIL 


SDSTRP 


SENDV 


SENTID 


SENTRP 


SEROUT 


SEXTDT 


SEXTIM 


SFIB 


Function Description 


(2) 


Delete overlay area table 


Delete segment 


Delete semaphore 


Delete task 
Disable device 


Dissociate file 


Disable user trap 

Enable device 

Entry point 

identification 

Enable user trap 

Error output file - write 

to 

External date/time - convert 


to 


External time - convert 
to | 


File information block - 
create or change 


Function 
Code 
(3) 


Function 
Code. 
(4) 


Overlay 
handling 


Task control 


Semaphore 
handling 


Task control 
Physical I/0 


File manage- 
ment 


Trap handling 
Physical I/O 
Tdentification 
and informa- 
tion 

Trap handling 
Standard 
system file 


I/O 


Date/time 


Date/time 


Data struc- 
ture genera- 
tion 
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Table 1-1 (cont). System Service Macro Calls 


Function 
Group 
(4) 


Macro 
Call Name 


(1) 
SMGCRT 


Function Description 


(2) 


Data struc- 
ture genera- 
tion 


Message group 
block offsets 


control request 


Data struc- 
ture genera- 
tion 


SMGIRB 


Message group initialization 
request block 


Data struc- 
ture genera-— 
tion 


Message group initialization 
request block offsets 


SMGIRT 


Data struc- 
ture genera- 
tion 


SMGRRB Message group recovery request 


block 


SMGRRT Data struc- 
ture genera- 


tion 


Message group recovery request 
block offsets | 


SMINIT Message group, initiate Intergroup 
message 


facility 


Identification 
and 
information 


SMODID Mode identification 


SMRECV Message group, receive Intergroup 


message 
Facility 


SMSEND Message group, send Intergroup 
message 


facility 


Intergroup 
message 
Facility 


terminate 


Message group, 


SNCIN New command-in Standard sys- 


tem file I/O 


SNPROC New process Task group 


control 
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Macro 


Call Name 


(1) 


SNUIN 


SNUOUT 


SOPFIL 


SOPMSG 


SOPRSP 


SOVEXC 


SOVLD 


SOVRCL 


SOVRLS 


SOVRSV 


SOVST 


SOVUN 


SPERID 


SPRBLK 


SRBADD 


Table 1-1] 


(cont). 
Function Description 
| (2) 


New user input file - 


New user output file - 
redefine 

Open file 

Operator information 
message —- display only 


Operator response 
message - display/respond 


Overlay, execute 


Overlay, load 


Overlay release, wait, and 
recall 

Overlay area, release 
Overlay area reserve, and 
execute overlay 

Overlay status 


Overlay, unload 


Person identification 


Parameter block 


Return request block 
address 


Function 


Code 


(3 ) 


0804 


0805 


1050/1051 


0900 


0901 


0700 


0701 


0707 


0706 


0705 


0703 


070C 


1401 


System Service Macro Calls 


Function | Secu” 
Group 
(4) 


Standard sys- 
tem file I/O 


| Standard sys- 


tem file I/0 


File manage- 
ment 


Operator 
interface 


Operator 
interface 


Overlay 
handling 


Overlay 
handling 


Overlay ‘ 
handling 


Overlay 
handling 


Overlay 
handling 


Overlay 
handling 


Overlay 
handling 


Identification 
and 
information 


Data struc- 
ture genera- 
tion 


Request and 

return fo 
y 
7/79 
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Table 1-1 (cont). System Service Macro Calls 


Function 
Function Description Code Group 


Macro Function 
Call Name 


SRDBLK Read block 

SRDREC Read record 
ment 

SRDSW Read external switches External 
Switch 

SRDVAT Reset device attention Physical I/0 

SRETRN Return sequence - establish Request and 
return 

SRLSM Release semaphore 0603 Semaphore 
handling 

SRLIML Release terminal 1704 Terminal 
Function 

SRMEM Return memory; return 0404/0405| Memory 
[allocation 

SRMFIL | Remove file 1025 File manage- 
ment 

SRNFIL Rename file/directory 1040 File manage- 
ment 

SROLBK Roll back 0c14 Task control 

SRPTER Report error condition OFOO/OFO1 {Error 
handling 

SROBAT Request batch execution OE0O Batch 

SROCL Request clock 0500 Clock 

SRQGRP Request group ODO00 Task group 


control 
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Macro 


Call Name. 


SRSVSM 


SRWREC 


SSDL 


SSETSW 


SSGTRP? 


SSPGRP* 


SS PTSK 


SSRB 


SSRBD 


SS 'TMP* 


SSTTY 


SS US PG 


Function Description 


Request I/0 transfer 


Request semaphore 


Request terminal 


Request task 


Reserve semaphore 


Rewrite record 


Set dial 


Set external switches 


Signal trap 


Spawn group 


Spawn task 


| Semaphore request block 


Semaphore request block 
offsets 


Status memory pool 


Set terminal file 
characterstics 


| Suspend group 


Function 
Code 


1140/1141 


1B00 


OBOl 


0A03 


ODO05 


0C05/0C06 


Table 1-1 (cont). System Service Macro Calls 


Function ee 


Group 


Physical 1/0 


Semaphore 
handling 


Terminal 
function 


Task control 


Semaphore 
handling 


Data manage- 
ment 


Communica- 
tions 


External | 
Switch Pan 


Trap handling 


Task group 
control 


Task control 


Data struc- 
ture genera- 
tion 


Data struc- 
ture genera- 
tion 


Memory allo- 
cation 


File manage- 
ment 


Task group 
control 


7/19 
CB08-02A 


Jl, 


Table 1-1 (cont). System Service Macro Calls 


Macro Function | Function 
Call Name Function Description Code Group 


(1) (2) (3) (4) 
a a a ee ee | 


SSUS PN Suspend for interval; 
Suspend until time 


b 
SSUSPT Suspend task Task control 


SSWFIL Swap file File 
management 


SS YSAT System attribute information Identification 
and 
information 


SSYSID System identification Identification 
and 
information 


STC PUR? Task CPU time Date/time 
remaining 


STEST Test completion status Request and 
return 


STFIB File information block - Data structure 
, offsets generation 


STGIN Task group input Identification 
and 
information 


STIFIL file for input File manage- 
ment 


b : : ee : 
STINFO information Identification 
and 
information 


STOFIL file for output File manage- 
ment 


STRB request block Data structure 
generation 


STRBD request block offsets Data structure 
generation 
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Macro 


| Call Name 


STRMRO 


STR PHD 


STRPHD? 


| SUNSBU 


SUSIN 


SUSMSG” 


SUSOUT 


SUSRID 


SUSRSP° 


SWAIT 


SWAITL 


SWIFIL 


SWLIST 


SWOF IL 


SWRBLK 


SWRREC 


Table 1-1 (cont). 


Function Description 


Terminate request 


Trap handler connect 
Trap handler, query 


Unload sharable bound unit 


User input file - read 


User message 


User output file - write 


User identification 


User response message 


Wait for operation 
complete 


Wait on request list 


Wait for file input 


Wait list structure 


Wait for file output 


Write block 


Write record 


PART 


Function 


0103/010 


OA00 


OA04 


070E 


0800 


1700 


0801 


1400 


1065 


1210/1211 


1120/1126 


System Services Macro Calls 


Function 


return 
Trap handling 
Trap handling 


Overlay hand- 
ling 


Standard sys- 
tem file I/0 


Intergroup 
task message 


Standard sys- 
tem file I/0 


Identification 
and 
information 


Intergroup 
task message 


Request and 
return 


Request and 
return 


File manage- 
ment 


Data structure 
generation 


File manage- 
ment 


Storage 
management 


Data manage- 
ment 
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TCBs representing task code are assigned to execute on phys- 
ical priority level of the central processor. One or more TCBs 
may be assigned to use a level, and will be queued awaiting 
availability if there is a request for the task. When the TCB 
heading the level queue terminates with an empty request queue or 
is temporarily suspended by the system, the next TCB on that 
level moves to the head of the level queue. The system may sus- 
pend a task while processing a system service call, e.g., fetch- 
ing a system overlay; the task may also explicitly suspend by 
performing a wait or suspend operation. When a suspended task 
reactivates, its TCB is placed at the end of the appropriate 
level queue. 


The following sequence of events illustrates an example of 
request queue manipulation as one task (e.g., task A, identified 
aS logical resource number 1 at priority level 7) requests the 
execution of another task (e.g., task B, identified as logical 
resource number 2 at priority level 10, a lower priority level) 
and later waits for completion of the requested task. 


1. Task A requests task B (specifying logical resource 
number 2 in the request block). The task manager places 
this request block at the end of the request queue for 
Task B which executes at priority level 10. See Diagram 
Ls 


ANOTHER REQUEST 
REQUEST BLOCK 


BLOCK FROM TASK A 


TASK B REQUEST QUEUE 


Diagram 1 - Request Block From Task A is Queued in 
Request Queue for Task B 


2. Task A issues a wait call, indicating that it wishes to 
be suspended until its request for Task B is completed. 
Task A is now suspended. 


3. Task B runs and terminates relative to the first request 
block in the request queue for the task. As Task B 
terminates, the first request block is removed from the 
request queue for the task. See Diagram 2. The TCB for 
Task B on priority level 10 remains active because 
another request block (the one generated by Task A) ex- 
ists in its request queue. 
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ANOTHER 
REQUEST 
BLOCK 


REQUEST 
BLOCK 
FROM TASK A 


oN 


eee 


TASK B REQUEST QUEUE 


Diagram 2 - First Request Block is Dequeued as Task B 


4. 


Terminates Relative to It 


Task B runs and terminates relative to the request block 
generated by Task A. Task A, which was waiting for this 
event, is now reactivated. The request block generated 
by Task A is removed from the request queue for priority 
level 10. Task A will resume execution when priority 
level 7 becomes the highest active level, and the Task A 
TCB again reaches the beginning of the level 7 TCB 


‘queue. 
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Function Macro Call 
Home directory pathname SHDIR 
Bound unit identification SBUID 
System identification SSYSID 
Task group account identification SACTID 
Task group input file name | STGIN 
Task group mode identification SMODID 
Task group person identification SPERID 
Task group user identification SUSRID 
Entry point identification SENTID 
Group information SGINFO 
Group identification SGRPID 
Group status information SGRPST 
Installation identification SINSID 
Task information STINFO 
System attribute information, get SSYSAT 


MEMORY ALLOCATION FUNCTIONS 


The macro calls for memory allocation functions allow you to 
dynamically obtain memory from the task group's memory pool, to 
return this memory when it is no longer needed, and ascertain the 
amount of memory available in a specified pool. 


The macro call that allocates a memory block has two forms: 
one form allows you to obtain a memory block of the specified 
size only; the other allows you to obtain the largest existing 
contiguous memory block if a block of the specified size cannot 
be found. The macro call that returns a memory block also has 
two forms: one form allows you to return an entire memory block; 
the other allows you to return a specified part of the block. 


The macro routines/calls are: 
Get memory; get available memory SGMEM 


Return memory; return partial SRM EM 
block of memory 


Status memory pool SSTMP 


MESSAGE FACILITY FUNCTIONS 


The message facility allows two task groups, uSing assembly 
language code, to have online communication between them by 
sending a message (one or more records) through message queues 
called mailboxes. A message group is a set of records that con- 
stitute a message sent through a mailbox. 
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The message facility macro calls are issued by the task 
groups to perform message group and message functions. (The 
MOD 400 System Concepts manual describes the message facility.) 


The intergroup message facility macro calls have the follow- 
ing functions: | 


o Open the send function of the message facility (accept) 
o Ascertain number of messages in the mailbox 


o Open the receive function of the message facility 
(initiate) 


o Terminate the message group 
o Receive the data 
o Send the message data 


The message facility macro calls are: 


Message group, accept SMAC PT 
Message group, count SMCMG 
Message group, initiate SMINIT 
Message group, terminate SMTMG 
Message group, receive SMRECV 
Message group, send SMS END 


INTERGROUP TASK MESSAGE FUNCTIONS (MOD 600 ONLY) 


The macro calls for intergroup task message functions permit 
communications between tasks in different task groups by: 


o Sending a message between tasks in separate task groups 


o Sending a message from a task in one group to a task in 
another, and receiving a response 


The macro calls use an intergroup request block, discussed 
in Section 4 and detailed in Appendix A. 


The macros are: 


User message SUSMSG 
User response message SUS RSP 


OPERATOR INTERFACE FUNCTIONS 


The macro calls for operator interface functions enable 
tasks to communicate with the operator terminal by: 
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o Displaying an information message on the operator 
terminal 


o Sending a message to the operator terminal and re- 
ceiving a response 


o Activating or deactivating console suppression, i.e., 
Suspend or restore issuance of messages to the operator 
terminal for the issuing task group 


The macro routines/calls are: 


Console message suppression SCMSUP 
Operator information message SOPMSG 
Operator response message SOPRSP 


THE SOPMSG and SOPRSP macro calls require input/output re- 
quest blocks (IORB's), which can be generated by the SIORB macro 
call (see Sections 4 and 5 and Appendix A). 


OVERLAY HANDLING FUNCTIONS 


Overlays may be loaded at a fixed displacement from the base. 
of the root-segment at link time, or if "“floatable," into a block 
of memory allocated explicitly by the user or implicitly by the 
system. 


The user may create a set of overlay areas and have the sys- 
tem load floatable overlays into them, managing the availability 
of free areas, and locating available copies of requested 
overlays. The user may unload from memory, at one time, all 
Sharable bound units with a user count of zero. 


The macro routinesS/calls are: 


Overlay, release, wait, and recall SOVRCL 
Overlay area, release SOVRLS 
Overlay area reserve, and execute overlay SOVRSV 
Create overlay table SCROAT 
Delete overlay area table SDLOAT 
Overlay, execute SO VE XC 
Overlay, load SOVLD 
Overlay status SOVST 
Overlay, unload SOVUN 


PHYSICAL I/O FUNCTIONS 


The macro calls described in this subsection allow you to 
interact with device drivers. If direct access to devices is not 
a requirement, use the File System macro calls. 
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The physical I/O macro calls allow you to: 


f * 

o Request input and output a 

o Disable a device when an attention interrupt occurs 

o Set the resource control table (RCT) of a device to the 

enable status 
o Turn off the attention status indicator in the RCT of 
the Specified device 

See Section 6 for a complete description of Level 6 physical 
I/O functions, including details on device drivers and resource 
control tables. 

The macro routines/calls for physical I/O are: 

Disable device on attention SDSDV 

Enable device SENDV 

Reset device attention SRDVAT 

Request I/O transfer SRQIO 
REQUEST AND RETURN FUNCTIONS 

The macro calls for request and return functions enable you 
to control requests for tasks and to provide a standard return #8 
sequence for called subroutines. Specifically, the macro rou- { 
tines are used to: ee 


o Terminate the current execution of a task 
o Wait for the completion of another task 
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4. Task B issues a $RLSM when it finishes with the re- 

_ source; the counter is incremented to 0, Task C now gets 
the resource. After the $RLSM for Task C, the value is 
1 again. 


Use of reSources by more than one user at a time can be ar- 
ranged by adjusting the initial value of the semaphore, e.g., an 
initial value of 2 allows two users, a value of 4 allows four 


users, and so on, depending on the nature of the resource and its 
intended use. 


If it is undesirable for a task to be suspended while a re- 
source is in use, the SRQSM macro call can be used instead of 
SRSVSM to reserve a resource. SRQSM is an asynchronous reserva- 
tion request (SRSVSM is a synchronous request) which causes a 
request block to be queued for the resource, so that the issuing 
task can do other processing before the needed resource is 
available. 


The macro routines/calls for semaphore handling are: 


Cancel semaphore request SCNSRQ 
Define semaphore SDFSM 
Release semaphore SRLSM 
Request semaphore SRQSM 
Reserve semaphore SRS VSM 
Delete semaphore SDLSM 


STANDARD SYSTEM FILE I/O FUNCTIONS 


The macro calls for standard system file I/O functions make 
the standard system files (command-in, user-in, user-out, and 
error-out) available to a task group. Other macro calls shown 
below allow the task to redefine the uSer-in and user-out files. 
Specifically, the macro routines enable you to: 


Read the next record from the command-in file 
Write the next record to the error-out file 
Read the next record from the user-in file 
Write the next record to the user-out file 
Redefine the user-in file 

Redefine the user-out file 


000000 


The macro routines/calls are: 


Command in (read command-in file) SCIN 
Error output file SEROUT 
New command in SNC IN 
New user input file SNUIN 
New user output file SNUOUT 
User input file SUSIN 
User output file SUSOUT 
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TASK CONTROL FUNCTIONS 


The macro calls for task control allow you to: 


oO 


oO 


Cancel a previously issued request 


Create, request, spawn, suspend, activate, delete, and 
abort a task : 


Attach, load, and detach a bound unit to/from a task 
Create and delete a segment for a task's bound unit 
Process command lines 


Roll back (recover) updated records in all files updated 
Since the last execution of clean point. 


Define "clean" point at which updated records are valid 
and may be recovered; unlock records for all files in 
the task group 


Some macro calls involve the use of request blocks. Sec- 
tions 4 and 5 discuss and describe macro calls that generate re- 
quest blocks; Appendix A shows the format of the request blocks. 


Macro routines/calls for task control are: 


TASK 


Cancel request SCANRQ 
Clean point SC LPNT 
Command line, process SCMDLN 
Create task SCRTSK 
Delete task SDLTSK 
Request task SROTSK 
Spawn task SS PTSK 
Bound unit, attach SBUAT 

Bound unit, load SBULD 

Bount unit, detach SBUDT 

Unload sharable bound unit SUNSBU 
Create segment SCRSEG 
Create maximum segment SCRMSG 
Delete segment SDLSEG 
Suspend task SS US PT 
Activate task SACTVT 
Kill task SKILLT 
Roll back SROLBK 


GROUP CONTROL FUNCTIONS 


A task group is a named set of one or more tasks, memory 


space, files, peripheral devices, and priority levels. Any num- 


ber of task groups may be defined. 


The macro calls for task 


control allow you to: 
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a o Create a file 

( o Delete a file 
o Get a file (reserve a file for processing) 
o Open a file 
o Close a file 
o Remove a file from processing 
o Rename a file 
o Associate a logical file number with a pathname 
o Dissociate a logical file number from a pathname 
o Create a directory 
o Delete a directory 
o Rename a directory 
o Change the working directory 

i | o Get the name of the current working directory 


o Expand pathname (develop a full pathname from a 
relative pathname) 


o Get information about a file 
o Test the status of an I/O activity (terminal) 


o Wait for the completion of an asynchronous I/O activity 
(terminal) 


o Set the file characteristics of a terminal 

Some of the macro calls use file information blocks (FIBs); 
some can use FIB offsets or parameter structure offsets. The 
macro calls available to generate FIBs and offsets are summarized 
in Section 4 and described in detail in Section 5. 


The macro routinesS/calls for file management are: 


Associate file SASFIL 
Change working directory SCWDIR 
Close file SCLFIL 
Create directory SCRDIR 
Create file SCRFIL 
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Delete file 

Delete directory 

Dissociate file 

Expand pathname 

Get file | 

Get file information 

Get working directory 

Open file 

Release directory 

Release file 

Remove file 

Rename file/directory 

Set terminal file 
characteristics 

Test file for input 

Test file output 

Swap tape file 

Wait for file input 

Wait for file output 


SDLFIL 
SDLDIR 
SDS FIL 
SXPATH 
SGTFIL 
SGIFIL 
SGWDIR 
SOPFIL 
SRLDIR 
SRLFIL 
SRMFIL 
SRNFIL 
SSTTY 


STIFIL 
STOFIL 
SSWFIL 
SWIFIL 
SWOF IL 


Section 5 describes these macros in detail. 


Many of the macro calls can be logically paired, as follows: 


Open file - Close file 


fe) 
a o Create file - Delete file 
o Associate file - Dissociate file 
o Get file -—- Remove file | 
fel o Create directory - Delete directory 
Although the following functions are available through macro 
calls, they are typically performed outside of program execution 
via execution control commands. 
o Associate file 
o Dissociate file 
o Get file 
o Remove file 
o Create file 
a o Delete file 
o Rename file 
o Create directory 
a o Delete directory 
o Change working directory 
o Get working directory 
o Set terminal file characteristics. 


Figure 3-1 shows the life cycle of a file. 


Create file 


(SCRFIL) and get file (SGTFIL) are actually on the same level. 
The same is true for delete file (SDLFIL) and remove file 


(SRMFIL). 


(Associate file and dissociate file provide a way of 


supplying a pathname as input to create file and get file.) 
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SECTION 4 


DATA STRUCTURE GENERATION 


This section summarizes the macro routines that generate 
and/or define the system data structures. There are two kinds of 
data structures, those that apply to the monitor service func- 
tions, and those that apply to the file system functions. 


The macro calls for data structure generation for both 
monitor services and for the file system functions, are described 
in detail in Section 5, in the alphabetic order of their function 
descriptions (see column 2 of Table 1-1). 


NOTE: Macro calls that are usable with only one operating 
system, (e.g., MOD 400 or MOD 600) are so identified 
in Table 1-1 and in Section 5. 


MONITOR SERVICES DATA STRUCTURES 
Monitor service data structures are the following: 


o Request blocks 
o Parameter block and wait list 
o Request block offsets 


The macro routines for generating the monitor services data 
structures, Summarized in this subsection and described in 
Section 5, cannot be used in programs written in SAF/LAF inde- 
pendent code (SLIC). See the Assembly Language Reference manual 


56 


' for detailed information about SAF/LAF independent code. 


Request Blocks 


Request blocks are data structures used by an application to 
coordinate the processing of events. The request blocks provide 
a standard system interface that specifies the conditions for 
execution to proceed. For example, one element in a request 
block can be set to indicate that a task issuing a request for 
another task has the option to wait until the second task fin- 
ishes processing before the issuing task continues its own 
processing. 
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Request blocks provide the means of specifying the following 
options: 


Wait for requested task completion 
Explicit start address of requested task 
Termination action for requested task 
Delétion of request block upon termination 


OO000 


The wait option allows synchronization of a requesting and a 
requested task; for example, the issuing task could name a sema- 
phore to be released or it could specify an address of a request 
block to be scheduled. 


The selection of an explicit start address allows a request- 
ing task to control the entry point of the requested task. 


Possible termination options of the requested task include 
release of a semaphore or request of another request block on 
task termination. These options allow flexible synchronization 
among tasks of an application and permit the issuing task to 
terminate before the requested task completes. For example, a 
Slave task that runs asynchronously with the remainder of the ap- 
plication can repetitively reserve a semaphore and be activated 
only by release of that semaphore as requested at termination of 
other tasks. The option of scheduling another task request at 
task termination allows, for example, a dispatching task to be 
notified of completion of certain tasks without explicitly wait- 
ing for their completion. 


The request block deletion option causes the system to re- 
turn the request block to the appropriate pool upon task termina- 
tion without further application intervention. 

Often used in conjunction with the semaphore and/or schedule 
request options, this is a way for memory to be properly returned 
even though the issuing task has itself terminated. For example, 
the system uses this feature on asynchronous task requests such 
as Spawn Task, with the NWAIT argument. 

These options are controlled by the following specific bits 
in the request blocks, and apply to all types of requests (unless 
otherwise indicated). 

o W-bit, or wait 


o I-bit, or implicit start address (not optional for 
IORBs or clock request blocks (CRBs), always set) 


o S-bit, or semaphore 
o R-bit, or return request 
o D-bit, or delete 
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ACCOUNTING FILES, OPEN 
(MOD 600) 


ACCOUNTING FILES, OPEN (MOD 600 ONLY) 
Macro Call Name: SACTOP 

Function Code: 1E/04 

Equivalent Command: None 


Open the system's accounting files, and make them available 
to this user. 


FORMAT : 
[label] SACTOP 
ARGUMENT DESCRIPTION: 
None 
FUNCTION DESCRIPTION: 


This call opens the system accounting files to access by an 
authorized user. (This call must precede all other account- 
ing macro calls, except SACUPD). 


The system automatically activates the accounting function 
and creates the accounting files when the operator startup 
EC file includes the MESSAGE OF THE DAY command. Unless 
this command is removed from the startup EC file, the 
accounting function will be in the system; accounting data 
will be accumulated and placed in the raw accounting file. 


NOTE: A user who does not utilize the accounting function, 
when it is present in the system, should, with the 
CLEAR ACCT command, or with his own program, period- 
ically delete the automatically generated and accumu- 


lated accounting records from the raw accounting 
file. 


Accounting uses these system accounting files: 


o Raw accounting file (ACCT.SA. RAW) 
o Update accounting file (ACCT.SA.UPDT) 
o Hold accounting file (ACCT.SA.HOLD) 
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The accounting function creates, for every user who logs in, 
an accounting record for that login period only. When that user 
logs off, the record is written to the raw accounting file. If 
the same user again logs in, the system creates another account- 
ing record. (See the accounting record, read from raw accounting 
file (SACTR1) macro call for a description of the raw accounting 
record.) 


Accounting information in an accounting record comprises the 
following: | | 


1. Date and time user logs in 

2. Date and time user logs off. 

3. Central processor time used (in milliseconds) 
4. Number of lines printed 

5. Number of cards read 

6. Number of cards punched 


7. Number of physical I/O order issued (inclusive of 4, 5, 
and 6) 


8. Number of times user program was rolled out 
9. Number of times overlay area table (OAT) was loaded 
10. Number of times OAT was already in memory 
ll. Number of pages printed 
12. $jGroup's base software level 
13. Name of terminal 
14. Name of last bound unit loaded 
Accounting information is numeric binary. The user is 
responsible for retrieving the data from the raw accounting file, 
for changing that data into units/dollars to be charged or 
reported, and for writing that data out to the accounting update 


file. 


A possible user accounting program sequence might be the 
following: | 


1. Issue SACTR1 call to read the next record from the raw 
accounting file. (SACTOP must be first call issued.) 


2. Convert data from raw accounting file, into the update 
record. 7/79 
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STORE 


ST BLK 


STH 


BDEC 


ADV 


BDEC 


JMP 


LDV 


B 


SR6, SB3.-SR3 
SR4,>NXTCHR 
SR3, 3 


$R5,>NXTWRD 


SB5 
SR6,'A' 


2STORE 


STORE 1] BYTE, STARTING FROM RIGHT OF 
A 3-BYTE GROUPING; BRANCH TO GET NEXT 
UNTIL SR4 = -l : 


BRANCH TO GET NEXT WORD UNTIL SR5 = 
-l 


RETURN TO CALLER 
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ACCOUNTING RAW RECORD, WRITE 
(MOD 600) — lan 
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ACCOUNTING RAW RECORD, WRITE (MOD 600 ONLY) 
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Macro Call Name: SACTW1 


Function Code: 1E/02 
a Equivalent Command: Write Accounting Record (WRITE ACCT R) 


Write a raw record to the raw accounting file. 


FORMAT : 


[label] SACTW1 [location of the record to be written out], 
| [location of the record length (in bytes) ] 
z | [location of record type number] 


ARGUMENT DESCRIPTION: 
location of record to be written out Sw 


Any address form valid for a data register; provides 
the address of the raw record to be written to the raw 
accounting file. 


location of length of record to be written out 


Any address form valid for a data register; provides 
the address of the length of the record to be written 
out. Length is in bytes (decimal). Default value is 
ZeEYO. 


location of record type number 


Location of the record type number (2 to 65,535) of 
the record to be written, which is loaded into $R7 
prior to the macro call. If this argument is not 
specified, it is assumed to have been loaded into SR7. 


XK 
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FUNCTION DESCRIPTION: 


This call should be used only when the user has implemented 
his own accounting system, e.g., to provide only selected 
accounting information such as measuring disk use. For a 
user-designed system that uses the accounting record, the 
following rules apply: 


1. The user must reserve 16 bytes for record header infor-a 


mation. 


User character data may not exceed 162 bytes. 


2. Record length may not exceed 178 (decimal) bytes. 


3. When record length is less than 178 bytes, the user must 
provide the length in $R6, or provide a pointer to the 
location where the length value is stored. 


This call writes a user-designed accounting record, which 
must conform to the above rules, into the raw accounting 


file. 


NOTES: 


l. 


This call must be preceded by successful execu- 
tion of the SACTOP macro call. 


The address of the record to be written out, 
supplied by argument 1, is placed in $B4. When 
this argument is omitted, the system assumes 
that $B4 contains this address. 


The length of the record to be written out, sup- 
plied by argument 2, is placed in $R6. When 
this argument is omitted, the system sets $R6 to 


zero (the default record length). 
On return, SR1l contains one of: 


0000 - No error 


0824 - Request canceled; accounting files were 
not opened. 
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ACCOUNTING UPDATE RECORD , DELETE oe, 
(MOD 600) 


ACCOUNTING UPDATE RECORD, DELETE (MOD 600 ONLY) 
Macro Call Name: SACTD2 

Function Code: 1E/13 
Equivalent Command: None 


Delete the current update record from the accounting update 
file. 


FORMAT : 
[label]  SACTD2 


ARGUMENT DESCRIPTION: 


re 


None 
FUNCTION DESCRIPTION: 


This call deletes the current update record (the last update 
record read) from the accounting update file, and is effec- 
tive only when a successful SACTR2 macro call was the last 
operation against that file. 


The record to be deleted is the last update record read into 
the accounting update file. A deleted record can no longer 
be read by any other user, but any update record in the 
user's receiving area (See the SACTR2 macro call) is not 
affected by the SACTD2 macro call and remains available to 
the user until a subsequent record is read into the receiv- 
ing area. 


This macro call should be used only when an update record 
causes an error condition to be reported by the system 
administrator command UPDT ACCT, which normally deletes 
update records after it has successfully processed them. 
When the update record causeS an error, the system leaves 
that record in the update file for uSer correction. 
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ASSOCIATE FILE 


ASSOCIATE FILE 

Macro Call Name: SASFIL 

Function Code: 10/10 

Equivalent Command: Associate Path (ASSOC) 


Associate a logical file number (LFN) with a specific path- 
name. This association is typically done outside of program 
execution to allow the program to be run against a pathname 
that is not known until execution time. The SGTFIL macro 
call or GET command may be more useful. 


FORMAT: 


[label] SASFIL [argument structure address] 


ARGUMENT DESCRIPTION: 
argument structure address 


Any address form valid for an address register; pro- 
vides the location of the argument Structure defined 
below. The argument structure must contain the fol- 
lowing entries in the order shown. 


logical file number 


A 2-byte logical file number (LFN) used to refer 
to the file; must be a binary number in the 
range 0 through 255. 


pathname pointer 


A 4-byte address, which may be any address form 
valid for an address register; points to a path- 
name (which must end with an ASCII space charac- 
ter) to be associated with the LFN. 
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FUNCTION DESCRIPTION: 


This macro call establishes a logical connection between an 
LFN and a pathname. It does not reserve a file or check to 
determine whether or not the pathname identifies an existing 
file or directory (i.e., the pathname entry may identify an 
incomplete pathname, such as VOL1 SUBA ). Subsequent macro 
calls (e.g., change working directory) have no effect on a 
previously associated pathname because the pathname identi- 
fied in this macro call is fully expanded at the time of the 
call. It should be noted that the association established 
is specific to a task group; that is, different task groups 
can associate different pathnames to the same LFN. 


NOTES: 1. If the argument is coded, the address of the 
argument structure is loaded into $B4; if the 
argument is omitted, $B4 is assumed to contain 
the address of the argument structure. 


2. On return, $R1l contains one of the following 
status codes: : 


0000 — No error 

0201 - Illegal pathname 
0202 - Pathname not specified 
0205 - Illegal argument 

0206 - Unknown or illegal LFN 
0210 - LFN already associated 


0222 - Pathname cannot be expanded, no working 
directory 


0226 -—- Not enough user memory for buffers or 
structures 
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BOUND UNIT, IDENTIFICATION 


BOUND UNIT IDENTIFICATION 

Macro Call Name: S$BUID 

Function Code: 14/06 

Equivalent Command: (MOD 600 only) USER BUID 


Returns the symbolic entry point name of the bound unit 


being executed by the issuing task to a 12-character 
receiving field. | 


FORMAT : 


[label] SBUID [location of bound unit id field address] 
ARGUMENT DESCRIPTION: 
location of bound unit id field address 


Any address form valid for an address register; pro- 
vides the address of a 12-character aligned, nonvary- 
ing receiving field into which the system will place 
the name of the current bound unit. 


FUNCTION DESCRIPTION: 


This macro call returns the symbolic entry point name of the 
currently executing bound unit to a specified field in the 
issuing task. The name returned is that specified in the 
first Linker EDEF directive whose address matches the entry 


point of the current task; if not found, the initial start 
address of the task. 


NOTES: 1. The address of the receiving bound unit id field 
supplied by argument 1 is placed in $B4; if this 
argument is omitted, $B4 is assumed to contain 
the address of the receiving field. 


2. On return, $R1 contains one of the following 
Status codes: 


ae 0000 - No error 
( 0817 - Memory access violation 
7/79 
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3. On return, SB4 contains the address of the 
receiving field. If not found, 12 blank charac- 
ters are placed in the receiving field. 


Example: 


In this example, $B4 is loaded with the address (BUNAME) of 
a 6-word field and the SBUID macro call is issued to place 
the name of the currently executing bound unit in that 
field. | : | 


BUNAME RESV 6,0 | 
LAB SB4, BUNAME 


e 


SBUID 
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( CHANGE USER, IDENTIFICATION 


CHANGE USER IDENTIFICATION (MOD 600 ONLY) 
Macro Call Name: SCUSID 

Function Code: OD/0OE 

Equivalent Command: None 


Change the user identification of the issuing task group to 
the specified id. 


NOTE: This macro routine is recommended for use only by 
specialized software system designers. 


FORMAT : 


[label] SCUSID [location of the identification field] 


ARGUMENT DESCRIPTION: 
location of the identification field 


Any address form valid for a data register. Provides 
the address of the changed user-id field, which 
consists of three elements as follows: 


12-character person_id 
12-character account __ id 
3-character mode 


Each element must contain exactly 12, 12, and 3 
characters, respectively, filled with trailing blanks 
if necessary. 


FUNCTION DESCRIPTION: 


This call changes the calling privileged task group's pre- 
vious user_id as specified in argument 1. For the call to 
be executed, the task must be executing in a privileged 
system group (initiated by a create systems group (SCSGRP) 
macro call or CREATE DAEMON GROUP (CDG) command). 
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The address of the new user_id field is placed 
in $B4. When the argument is omitted, the 
system assumes that $B4 contains the new 

user id. | 

On return, S$R1 contains the following: 

0000 — No error 


0602 - Memory unavailable 


O82E - Argument error; unable to pack identity 
field 


083A - Use of privileged executive function 
attempted. 
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CHANGE WORKING DIRECTORY 


CHANGE WORKING DIRECTORY 

Macro Call Name: S$CWDIR 

Function Code: 10/B0 

Equivalent Command: Change Working Directory (CWD) 


Change the working directory to the one specified in the 
macro call. This function is usually done outside program 
execution. 


FORMAT: 

[label] SCWDIR [argument structure address] 
ARGUMENT DESCRIPTION: 
argument structure address 


Any address form valid for an address register; pro- 
vides the location of the argument structure defined 
below. The argument structure muSt contain the fol- 
lowing entry. 


new working directory 


A 1l- to 45-byte pathname, which includes and 
must end with an ASCII space character, identi- 
fying the new current working directory. At 
least one nonspace character must be specified. 


FUNCTION DESCRIPTION: 


The specified pathname, which may be absolute or relative, 
must point to an existing directory; that is, this macro 
call does not dynamically create a directory. If a return 
status code other than 0000 is returned (see Note 2, below), 
an attempt is made to reestablish the previous working 
directory; if a subsequent error results, future functions 
may return an 0222 error code. 
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The system issues a mount request when a disk volume con- 


taining the new working directory is not mounted. 


The task 


is suspended until the volume is mounted or the operator 
cancels the mount request. 


NOTES: 1. 


Example: 


If the argument is coded, 


the address of the 


argument structure is loaded into SB4; if the 


argument is omitted, 


SB4 is assumed to contain 


the address of the parameter structure. 


On return, $R1 contains one of the following 
Status codes: 


0000 
Olxx 
0201 
0202 
0205 
0209 
020C 


0222 
0225 
0226 


0228 


No error 

Physical I/O error 
Tllegal pathname 

Pathname not specified 
Illegal argument 

Named directory not found 
Volume not found 


Pathname cannot be expanded, 
directory 


no working 
Not enough system memory for buffers or 
structures 


Not enough user memory for buffers or 
structures 


Illegal file type (not a directory) 


This. example is based on the following file system hierarchy 


(see the System Concepts manual): 
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oe 


hac 


ie é : 


If this argument is omitted, the value NWAIT is 
assumed. 


If WAIT is specified, argument 3 (termination action) 
must be omitted. 


termination action 


One of the following values is specified to indicate 
the action to be taken when the clock request is 
satisified. 


SM=aa - Do not suspend the issuing task; release 
(V-op) the semaphore identified by aa (two 
ASCII characters) when timeout has 
occurred. 


RB=label - Do not suspend the issuing task; issue a 
| request for the request block identified by 
label, when timeout has occurred. 


If this argument is omitted (or argument 2 is WAIT), 
the generated CRB contains no termination option. 


interval value 


Unit of time after which completion of the request 
will be posted; has one of the following values: 


MS=n 
TS=m 
SsC=m 
MN=m 
CT=m 


MS indicates milliseconds; TS tenths of seconds; SC 
seconds; MN minutes; and CT units of clock resolution. 


n is an integer value from 1 through 65535; m is an 
integer value from 1 through 32767. 


If this argument is omitted, the CRB is initialized 
with an interval value of zero milliseconds (MS=0). 


FUNCTION DESCRIPTION: 


The clock request block (CRB) is used as the standard means 
of synchronizing events with the passage of time. A CRB 
contains the time at which, or the interval after which, 
completion of the request is to be posted (marked as 
complete). 


There are two types of CRBS; regular and cyclic. 
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When the interval specified in a cyclic CRB has been satis- 
fied, it is automatically recycled to begin a new clock 
request for the initially specified interval. This process 
continues until a cancel clock ecquest macro call is issued 
for this CRB. 


A regular CRB is dequeued from the timer queue when the 
specified interval has been satisfied. A new request clock 
macro call must be issued to requeue the CRB. 


NOTE: This macro call cannot be used in programs written in 


SAF/LAF independent code (SLIC). See the Assembly 
Language Reference manual for more information about 
SAFVLAE independent code. 
Example: 
In this example, the $CRB macro call is used to generate a 
cyclic CRB with an interval of 500 milliseconds. The issu- 
ing task is not to be suspended. When the request has been 
satisfied, the issuing task will release semaphore XxX. 


CLKAA SCRB C,NWAIT,SM=XX,MS=500 
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on 


CLOCK REQUEST BLOCK OFFSETS 


CLOCK REQUEST BLOCK OFFSETS 
Macro Call Name: S$CRBD 
Generated Label Prefixes: 
C_RRB/C_SEM 
CRB label offset 0 
CCT 
Cc cT2 
C_TM 
See Appendix A for the format of the clock request block. 
DESCRIPTION: 


See the clock request block macro call. 


NOTE: This macro call cannot be used in programs written in 
SAF/LAF independent code (SLIC). See the Assembly 


Language Reference manual for more information about 
SAF/LAE independent code. 
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CLOSE FILE 
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CLOSE FILE 
Macro Call Name: SCLFIL 
Function Code: 10/55 (normal), 10/56 (leave), 10/57 (unload) 


Equivalent Command: None 


Terminates processing of the specified file. The file can- 
not be processed again until another open file macro call is 
issued. You identify the file to be closed by supplying its 
logical file number. | 


FORMAT: 


, NORMAL 
[label] SCLFIL [fib address] |4,LEAVE 
, UNLOAD 


a A 
Nmrces veel 


ARGUMENT DESCRIPTION: 
fib address 


Any address form valid for an address register; pro- 
vides the location of the file information block 
(FIB). The FIB must contain a valid LFN. 


NORMAL 
NOR 


Normal mode for closing files; the file can be 
reopened during execution of the task group. 


If the file is tape-resident, the end-of-file (EOF) 
labels are written (if necessary) and the tape is 
rewound to its beginning-of-tape (BOT) position. 


If the file is a terminal device, the line will be 
disconnected according to the specifications made at 
system building time. 


For card punch files a file card is punched. This 
card is recognized as the end of file for read A 
operations. a 
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NORMAL is the default value for this macro call. 


ehiae 
LEV 


For tape files is the same as for NORMAL mode, except 
that the tape is not rewound; i.e., remains at its 
current position. | 


For terminal device files, this indicates that the 
line is not to be hung up, regardless of the specifi- 
cation made at system building. 


For card punch files, this indicates that a file mark 
card is not to be punched. | 

—s 

UNL 


For tape-resident files the action is the same as for. 
NORMAL mode, except that after the rewinding, the tape 
is unloaded (i.e., cycled down). 


For terminal device files, the line is hung up 
(regardless of the specification made at system 
building time). 


FUNCTION DESCRIPTION: 


The fib address specified by the first argument of this 
macro call can refer to the same structure specified in the 
open file macro call with which this macro call is paired. 


This macro call causes all unwritten buffers to be written, 
records to be unloaded, and the logical end-of-file (EOF) 
label to be updated. However, the call does not remove the 
file (see the remove file macro call) from the task group 
(i.e., the file remains reserved for the task group and can 
be reopened). 


If the file being closed is a card punch, a file mark card 
is punched. (A card reader/punch is considered to be a card 
punch if the FIB program view word at open time had bit 2 
set to 1 (write permitted) and bit 1 set to 0 (read not 
permitted). 
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The following information applies only to magnetic tape. 
The actions performed on closing a tape file are determined 
by the way the write permit bit (bit 2) in the FIB program 
view word was set when the file was opened. Note that when 
a tape volume is opened for storage management access, and 
both volume and file names are not specified, then no 
| trailer labels nor tape marks are written; that is the 
user's responsibility. 


1. Write permission granted: 


ae If the file was opened in RENEW mode, the trailer 
label group is written, followed by an end-of-data 
(EOD) tape mark. This action is performed whether 
or not data records were actually written into the 
file. 


b. If the file was opened in PRESERVE mode the trailer 
label group and EOD tape mark will be written only 
if write operations were performed. In thiS case, 
data and/or files located beyond the current posi- 
tion of the tape are destroyed. 


If no write operations were performed, the trailer 
lable group will not be written and existing data 
and/or files located beyond the current position of 
the tape are preserved. 


c. If the LEAVE option is specified, the tape will be 
positioned at the end of the current trailer label 
group, unless the tape is being processed at the 
volume level. 


2. No write permission granted: 


a. If the end-of-file tape mark was detected, the 
trailer label group is processed and the action 
specified by NORMAL, LEAVE, or UNLOAD is taken. 


If the LEAVE option is specified, the tape is posi- 
tioned at the end of the current trailer label 
group. 


b. If the end-of-file tape mark was not detected, the 
trailer label group is not processed. When the 
LEAVE option is specified, the tape will be misposi- 
tioned. Opening the next file may result in an 
"invalid tape file header" condition. 


The file information block can be generated by a SFIB macro 
call. Displacement tags for the FIB can be defined by the 
STFIB macro call. 
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NOTES: 1. If the first argument is coded, the address of 
the FIB is loaded into $B4; if the argument is 
omitted, $B4 is assumed to contain the address 
of the FIB. : 


2. On return, $R1 contains one of the following 
status codes: 


0000 —- No error 

Olxx - Physical I/O error 
0205 - Illegal argument 

0206 — Unknown or illegal LFN 
0207 -—- LFN not open 


0225 —- Not enough system memory for buffers or 
structures 


0226 —- Not enough user memory for buffers or 
structures 


Example: 
In this example, it is assumed that the file opened in the 


example for the open file macro call is to be closed. The 
macro call is coded as follows: 


MYFIB DC 3. LFN 5 
CLFILA SCLFIL IMYFIB 


Since the second argument is not specified, the system 
assumes NORMAL mode. 
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COMMAND IN 


fo 
Nee 
COMMAND IN 
Macro Call Name: SCIN 
Function Code: 08/02 
Equivalent Command: None 
Read the next record from the standard command-in file for 
the issuing task. 
FORMAT: 
[label] SCIN [location of record area address], 
[location of record size], 
[byte offset of beginning of record area] 
ARGUMENT DESCRIPTION: | | —_ 
location of record area address 
Any address form valid for an address register; pro- 
vides the address of a record area in the issuing task 
into which the next record on the command-in file will 
be placed. 
location of record size 
Any address form valid for a@ data register; provides 
the size (in bytes) of the record whose address is 
given in argument l. 
byte offset of beginning of record area 
Any address form valid for a data register; provides 
the byte offset of the beginning of the record area 
(from the address provided in argument 1). 
a 
oy 
ee 
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COMMAND LINE PROCESS 


COMMAND LINE PROCESS 

Macro Call Name: S$CMDLN 

Function Code: 0C/08 

Equivalent Command: None 
Process the supplied command line by spawning a task to exe- 
cute the command named in the first argument of the macro 
call, and wait for the task's termination. 


FORMAT: 


[label] SCMDLN [location of command line address], 
[location of command line size] 


ARGUMENT DESCRIPTION: 
location of command line address 


Any address form valid for an address register; pro- 
vides the address of the supplied command line. 


location of command line size 


Any address form valid for a data register; provides 
the size (in bytes) of the command line to be 
processed. 


FUNCTION DESCRIPTION: 


This macro call allows you to embed commands in your pro- 
gram; see the Commands manual. The same task that executes 
the particular command when given from the terminal is 
Spawned to execute the command named in the macro call. 


The task spawned of behalf of the macro call is provided 
with a request block that has been constructed by the system 
to contain the edited arguments in system standard task 
request block format. The task that issues this macro call 
waits for the completion of the spawned task before 
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continuing its own processing. The spawned task passes the 
completion status ($R1) to the issuing task. 


NOTES: 1. The address of the command line, supplied by 
argument 1, is placed in $B4; if this argument 
is omitted, $B4 is assumed to contain the 
address of the command line to be processed. 


2. The size of the command line, supplied by argu- 
| ment 2, is placed in $R6; if this argument is 
omitted, S$R6 is assumed to contain the size. 


3. On return, SR1 and $B4 contain the followin 
information: : 


SR1 - Return status; one of the following:. 
0000 - No error 


OOO0-OOFF -—- Completion status returned by 
spawned task 


0601 - Insufficient memory 
0602 - Insufficient memory 


0805 - Unbalanced quotation marks, 
brackets, or parentheses 


080C ~ Unresolved symbolic entry 
point 


1609 - Invalid bound unit pathname 
for first argument 


160A - Insufficient memory. 


FFFF ~—- Honeywell component error pre- 
viously reported 


SB4 - Address of supplied command line 


Example: 


In this example, the SCMDLN macro call causes a command line 
to be processed which will execute the Assembler to assemble 
the source program MYPROG, residing in the current working 
directory. The Assembler will use 5K words of memory, taken 
from the issuing task group's memory pool, for its symbol 
table. The assembly listing will be written on the device 
named LPTO1l, and the object unit will be stored in the file 
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o An initial allocation of eight physical sectors (allowing 
32 entries) for diskette, eight physical sectors (allow- 
ing 64 entries) for cartridge disk and storage module 
(except 19-surface, 200 tracks-per-inch), or 16 physical 
sectors (allowing 128 entries) for 19-surface, 200. 
tracks-per-inch storage module. 


o An increment allocation of four physical sectors (allow- 
ing 16 entries each) for diskette, eight physical sectors 
(allowing 64 entries) for cartridge disk and storage 
module (except 19-surface, 200 tracks-per-inch), or 16 
physical sectors (allowing 128 entries) for 19-surface, 
200 tracks-per-inch storage module). 


o A maximum allocation of 4000 physical sectors (allowing a 
maximum of 16,000 entries) for diskette, or 4000 physical 
sectors (allowing a maximum of 32,000 entries) for car- 
tridge disk and storage module. 


NOTES: 


4. 


If the argument is coded, the address of the 
parameter structure is loaded into S$B4; if the 
argument is omitted, $B4 is assumed to contain 
the address of the parameter structure. 


On return, $R1l contains one of the following 
Status codes: 


0000 
O1lxx 
0201 
0202 
0205 
0209 
020C 


0212 


0215 


0222 


0224 


Successful completion 
Physical I/O error 

Illegal pathname 

Pathname not specified 
Illegal argument 

Named subdirectory not found 
Volume not found 


Attempted creation of existing file or 
directory 


Not enough contiguous logical sectors 
available 


Pathname cannot be expanded, no working 
directory 


Directory space limit reached or not 
expandable 
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0225 - Not enough system memory for buffers or (eX 


structures ‘ 
0226 - Not enough user memory for buffers or 
24 structures 
022C - Access control list (ACL) violation 
Example: 
In this example, the macro call is used to create the sub- 
directory, labeled SUBINDEX.A, identified in the create file 
example. This subdirectory must exist before the path iden- 
tified in that example (i.e., VOLO3>SUBINDEX.A>FILE A) can 
be used. Prior to issuing the create directory macro call, 
the following parameter structure and pathname must exist: 
SUBDIR DC <DIRPTH 
RESV 2-SAF 
RESV 2,0 
DIRPTH DC '*VOLO3>SUBINDEX.A ' 
The macro call can be specified as follows: ga 
SCRDIR  !SUBDIR 7 
a 
Ya 
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CREATE FILE 
(MOD 600) 


CREATE FILE (MOD 600 ONLY) 

Macro Call Name: SCRFIL 

Function Code: 10/30 

Equivalent Command: Create File (CR) 


Creates a new disk file by placing a description of the file 
in the file system hierarchy and, optionally, allocating 
space for it. The user identifies this file by either a 
logical file number (LFN) a pathname, or both. At the 
completion of create file execution, the file is reserved 
exclusively for the task group. If both an LFN and pathname 
are supplied then, in addition to creating and reserving the 
file, it is assigned to the LFN. Subsequent macro calls 
(open file, read record, etc.) can then be directed to the 
file via this LFN. SCRFIL can be used to create any of 

the disk files which are described in the Data File 
Organizations and Formats manual, including: 


o Fixed-Relative 
o Relative 

o Sequential 

o Indexed 

te) 


Random (calc) 


In addition SCRFIL can be used to create a temporary disk 
file which will exist only during this task group's 
execution. This function is normally done outside program 
execution. 


FORMAT : 


[label] SCRFIL [parameter structure address] 


ARGUMENT DESCRIPTION: 
parameter structure address 


Any address form valid for an address register; pro- 
vides the location of the parameter structure defined 
below. The parameter structure must contain the fol- 
lowing entries in the order shown. 
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logical file number gu 
A 2-byte logical file number (LFN) used to refer SS 
to the file. It must be a binary number in the 
range 0 through 255, ASCII blanks (2020) which 
indicates that an LFN is not specified, or -l 
(FFFF), which indicates that the system should 
assign an LFN from the pool of available LFNs. 


pathname pointer 


A 4-byte address of the pathname, which may be 
any address form valid for an address register; 
points to a pathname (which must end with an 
ASCII space character) that, when expanded, 
identifies (1) the name of the file to be 
created, and (2) the directory in the file sys- 
tem hierarchy in which to add the name and 
attributes of the file. Binary zeros (null 
pointer) in this entry indicate that a path is 
not specified; if the path identified is a 
Single ASCII space (20) character, the file 
being created is a temporary file. 


file organization 


A l-byte field specifying the file organization, 
as follows: 


2 - Fixed-relative without deletable 
records 


5 - Fixed-relative with deletable records 
R - Relative 

S - Sequential 

i = padexea 


C - Calc (random) 


A I-D-S/II data base area 
reserved 


This l-byte field must contain zeros. 


7/79 
5-86 CB08-02A 


KEY 


Example: 


0202 
0205 
0206 
0208 
0209 
020C 
0210 
0211 
0212 
0215 


0222 


0224 


0225 


0226 


022C 


Pathname not specified 

Illegal argument ; 

Unknown or illegal LFN 

LFN or file already open 

Same named subdirectory not found 
Volume not found 

LFN conflict 

Unable to establish unique LFN 
Attempted creation of existing file 


Not enough contiguous logical sectors 
available 


Pathname cannot be expanded, no working 
directory 


Directory space limit reached or not 
expandable 


Not enough system memory for buffers or 
control structures 


Not enough user memory for buffers or 
control structures 


Access control list violation 


In this example, the argument structure labeled FILE A, 
defined under "Assumptions for File System Examples" in 


Section 3, 


describes the file to be created. 


In addition, 


the following key descriptor structure has been defined: 


DC 


Z'00000000' RESERVED 
Z*0100' NO. OF COMPONENTS = 1 
4,0 RES ERVED 
Z'430A' KEY COMP. DATA TYPE = C; 
KEY LENGTH = 10 
1 KEY LOC. IN RECD. = FIRST POSITION 


Also, the pathname was defined as follows: 


IDXO1 


'“VOLO3>SUBINDEX.A>FILE AA’ 
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With the preceding definitions having been made, the fol- 
lowing macro call will create FILE A: 


DOM YAA SCRFIL !FILE A 
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CREATE A WORK SEGMENT OF UP TO 10K WORDS 
SCRMSG =B'000C110000000000' =10240 
CHECK FOR ERROR OR INSUFFICIENT MEMORY 
BNEZ NO GO 

SAVE THE SEGMENT'S ADDRESS AND SIZE 


STB $B2, SEG A 
SDI SEG S 


NOW DELETE THE WORK SEGMENT 


SDLSEG SEG A 
DC <$ 
DC 0B (31,0) 
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CREATE OVERLAY AREA TABLE 


CREATE OVERLAY AREA TABLE 
Macro Call Name: SCROAT 
Function Code: 07/0A 


Equivalent Command: None 


Create an overlay table to be used with overlay loading 
functions that require a pointer to an overlay area table 
(OAT). The overlay area described by this OAT is created in 
real memory space. (See the appropriate System Concepts 
manual for details on overlays and overlay area tables.) 


FORMAT: 


[label] SCROAT [location of OAT address], 
[location of size of overlay area entry], —_— 
[location of number of overlay area entries] ea 


ARGUMENT DESCRIPTION: 
location of OAT address 


Any address form valid for an address register; pro- 
vides the location into which the system will place 
the address of the OAT. | 


location of size of overlay area entry 


Any address form valid for a data register; provides 
the location of a value specifying the number of words 
to be contained in each entry in this overlay area. 
This value should be equal to or greater than the size | 
of the overlays to be placed in the area for loading. 


location of number of overlay area entries 


Any address form valid for a data register; provides a 
value specifying the number of entries in this overlay 
area. (The size of each entry is defined by argument 
2.) The value for this argument depends on the number 
of overlays of this size used by the bound unit and ia 
the frequency of their release. | a 
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FUNCTION DESCRIPTION: 


This macro call creates an overlay area table (OAT) to be 
used by subsequent loader functions that require (or imply) 
the existence of an OAT in the call. 


The real memory space for the overlay area described by this 
call is obtained from the same memory pool used by the cur- 
rent bound unit of the issuing task. If the current bound 
unit is not sharable, memory will be obtained from the pool 
associated with the group of the issuing task. If the cur- 
rent bound unit is sharable, memory will be obtained from 
the system pool. 


Once allocated, the overlay area table becomes a supporting 
resource of the current bound unit. That is, an OAT queue 
header field will be added to the definition of the bound 
unit descriptor, and as OATs are created, they will be 
placed in this queue. The OAT queue is maintained so that 
OATs are ordered by ascending area size. 


Before an OAT is allocated, any existing OATS are searched 
for an OAT with area size equal to that specified in argu- 
ment 2. If one is found equal, the number of areas in this 
OAT is returned to the caller (i.e., location specified in 
argument 1 or to register $R6). On return, the caller 


{ receives the address of the newly created OAT or an existing 
\ OAT. 


The overlay area reserve and execute overlay (SOVRSV) and 
overlay area, release (SOVRLS) macro calls require that 
overlay areas be present. If no OAT that controls entries 
of the specified size can be found, the system creates an 
overlay area with the number of entries specified by argu- 
ment 2, and then creates the controlling OAT. 


When the system returns the address of the OAT, it also 
returns the actual size of the overlay area and the actual 
number of areas allocated or already present. | 


NOTES: 1. The address of the OAT is returned in $B4 and is 
Stored as specified in argument 1]. I£ argument 
1 is omitted, the address is stored only in $B4. 


2. The size of the entry Supplied by argument 2 is 
placed in S$R2; if this argument is omitted, SR2 
is assumed to contain the correct size. 


3. The number of entries supplied by argument 3 is 


‘placed in $R6; if this argument is omitted, SR6 
is assumed to contain the correct number. 
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4. On return, $R1, SR2, SR6, and $B4 contain the 
following information: 


SR1 - Return status; one of the following: 


0000 


0602 


08 2D 


OE 02 


1602 


160A 


No error 


Insufficient memory; user system 
area or segment 


Group's available memory quota 
exceeded 


No memory available for nonswap- 
pable task 


Invalid argument (Size or number of 
overlay areas) 


Insufficient memory 


$R2 - Actual size of overlay area entry (if $R1_ 
is 0000); (for MOD 600, rounded up to 
nearest 256 words) 


SR6 - Actual number of overlay areas allocated 


to this area (if SR1 is 0000) 


SB4 - Address of OAT (if SR1 is 0000) 


5. On a return with error, the contents of S$R2, 
SR6, and S$B4 are unspecified. 


Example: 


In this example, an overlay area of three 512-word entries 
is created. (It is assumed that no existing overlay area 
table controls 512-word entries.) The address of the con- 
trolling OAT will be placed in OATAD. 


OATAD RESV 2,0 
SCROAT =OATAD, =512,=3 
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CREATE SEGMENT 
(MOD 600) 


CREATE SEGMENT (MOD 600 ONLY) 
Macro Call Name: S$CRSEG 
Function Code: O0C/0C 
Equivalent Command: None 


Create a segment in the task issuing this call; assign the 
segment to the initial bound unit. 


FORMAT : 


[label] SCRSEG [location of Segment access rights], 
[location of Segment size], 
[location of segmented address] 


ARGUMENT DESCRIPTION: 
location of segment access rights 


Any address form valid for a data register; provides 
the access rights (read, write, execute) for this 
segment, as defined by the hardware segment descrip- 
tor. Bits 0 through 5 of the register are used to 
specify the type of access, as follows: 


Bits Access Type 
0-1 Read 

2-3 Write 

4-5 Execute 


Ring access is coded as follows: 


Bit 
Values Ring 
00 3 
O01 2 
10 1 
11 0 
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Thus, for example, to read, write, and execute this 
segment from ring 3, bits 0 through 5 would be 000000. 


location of segment size 


Any address form valid for a double word data regis- 
ter (i.e., an address, or hexadecimal string if a 
constant); provides the segment's size, in words. A 
small segment must be less than or equal to 4K words 
(K=1024); a large segment must be less than or equal 
to 64K words. The actual size of the created segment 
will be the size specified, rounded up to the next 
256-word increment. 


location of segmented address 


Any address form valid for a data register; provides 
the address of any word in the segment. When null is 
specified, the system selects a segment number, 
consistent with the size as specified and with the 
availability of segment numbers to uSers. 


FUNCTION DESCRIPTION: 


The call permits the requesting task to dynamically create a 

segment of the size specified, and assign the segment to the 

initial bound unit associated with that task. The user can eG 
create private segments at link time, or dynamically with The mae 
this macro call. (The create maximum segment macro call 

(SCRMSG) allows the task to dynamically create a segment 

having the specified size or maximum available size.) 


Argument 3 allows the user to specify the segment number or 
have the system select the first available segment number. 


Conflicts in address assignments are the user's responsi- 
bility. The user can overwrite invalid segment descriptors, 
but cannot destroy protected overlay-area tables or 
addresses (e.g., group system area segment, group work area 
segment, and system segments). The user with write/execute 
access rights to the segment in the user ring can destroy 
that address. ) 


When the macro call is executed, $B2 contains a pointer to 
the start of the created segment. 


NOTES: 1. The MOD 600 System Concepts manual describes 
ring and segment access, Segment size, and 
segment numbers, in detail. 
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The segment's access rights value supplied by 
argument 1 is placed in SR2. When the argument 
is omitted, the system assumes that S$R2 contains 
this value. , 7/79 


The size of the segment supplied by argument 2 
is placed in $R6 and SR7. When the argument is 
omitted, the system assumes that $R6 and S$R7 
contain the segment size. 


The address of any word in the segment, supplied 
by argument 3, is placed in $B2. When the argu- 
ment is omitted, the system assumes that $B2 
contains the segmented address. When argument 3 
Specifies zero, the system selects the segment 
number. 


On return, S$Rl1, $R6, S$R7, and $B2 contain the 
following. (Contents of S$R6, $R7, and S$B2 are 
undefined for a return with an error.) 
SR1 - Return status code; one of the following: 
0000 —- No error 
0602 - Insufficient system memory 
0817 - Memory access violation; attempt to 
destroy an address (with the 
created segment) without the right 
to do so of: 
o Sharable bound unit root 
o System segment 
o Creating a nonuser segment 


0828 — No virtual address available to 
create segment 


082D - Group's available memory quota 
exceeded 


O82E - Argument error: 
o Size exceeds 64K 


o Size inconsistent with the 
specified segment number 


OF 02 —- No memory available for nonswap- 
pable task 
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SR6, S$R7 - Actual size of created segment 


$B2 - Pointer to start (offset = 0) of created 
segment 


Example: 


With the macro call, the requesting task creates a 2K-word 

segment, and asSigns it to the initial bound unit. Ring 3 

will have read and write access rights, but execute access 

is restricted to ring 0. The segment number of the created 
segment will be 2. | 


SCRSEG =B '0000110000000000'; 


=2048; 
+SA 
SA DC Z'00020000' 
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CREATE SYSTEM GROUP 
(MOD 600) 


CREATE SYSTEM GROUP (MOD 600 ONLY) 

Macro Call Name: S$CSGRP 

Function Code: 0D/02 

Equivalent Command: Create Daemon Group (CDG) 
Define a new task group with special privileges for perform- 
ing system functions. Allocate and initialize the data 
Structures necessary to control the new task group within 
the specified memory pool. Create the lead task as 


described in the create task (SCRTSK) macro call. 


NOTE: This macro routine is recommended for use only by 
Specialized software system designers. 


i FORMAT: 


Hy 


label SCSGRP [location of group identifier], 
[location of base level], 
[location of high logical resource number], 
[location of high logical file number], 
[location of root entry name address] 


ARGUMENT DESCRIPTION: 
location of group identifier 


Any address form valid for a data register; provides 
the group identification of the new task group. The 
group identifier must be a two-character (ASCII) name 
that may include the dollar sign ($) as its first 
character. 
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location of base level 


Any address form valid for a data register; provides 
the base priority level, relative to the system level, 
at which the lead task will execute. 


location of high logical resource number 


Any address form valid for a data register; provides 
the highest logical resource number (LRN) that will be 
used by any task in the task group. The LRN can be a 
value from 0 through FC (hexadecimal). If this argu- 
ment is omitted, or if the value specified is less 
than the highest LRN used by the system task group, 
the system task group's LRN will be used. 


location of high logical file number 


Any address form valid for a data register; provides 
the highest logical file number (LFN) to be used by 
any task in the task group. The LFN can be a value 
From 0 through FF (hexadecimal). If this argument is 
omitted, the value 15 is assumed. (Refer to the asso- 
ciate file macro call.) 


location of root entry name address 


Any address form valid for an address register; pro- 
vides the address of the root entry name string that 
Specifies the pathname of the bound unit to be exe- 
cuted as the lead task. The bound unit pathname can 
have an optional suffix in the form of ?entry, where 
entry is the symbolic start address within the root 
segment. If this suffix is not given, the default 
Start address (established at Assembly or Link time) 


is used. EC?ECL specifies the command processor as 
the lead task. | 
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CREATE TASK 
(MOD 600) 


CREATE TASK 
Macro Call Name: SCRTSK (MOD 600 only) 


Function Code: OC/02 (same bound unit), 
0C/03 (different bound unit) 


Equivalent Command: Create Task (CT) 


Add the supplied task definition to the set of currently 
defined tasks within the task group of the issuing task. 


FORMAT : 


[label] SCRTSK [location of logical resource number], 
[location of relative priority level], 
[location of start address], 
[location of root entry name address] 


%. 


ARGUMENT DESCRIPTION: 
location of logical resource number 


Any address form valid for a data register; provides 
the location of the logical resource number (LRN) by 
which the issuing task group can refer to the created 
task. The LRN (a value from 0 through 252) cannot 
exceed the value used as the high LRN in the create 
group macro call that created the group of which this 
task is a member. If the LRN value is set to -l, the 
system selects an available LRN, starting with the 
maximum, and returns it to the user in SR2. 


location of relative priority level 


Any address form valid for a data register; provides 
the location of the priority level, relative to the 
task group's base priority level, at which the created 
task is to execute. If this argument is omitted or is 
-l1, the priority level used is that of the issuing 
task. 
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location of start address 


Any address form valid for an address register; pr 
vides the location of the task start address when 
newly created task is to execute in the same bound 
unit as the task that issued the create task macro 
call. (Function code OC/02.) 


location of root entry name address 


Any address form valid for an address register; pr 
vides the address of the pathname of the bound uni 


O= 
the 


Oo~ 
c 


root segment to be loaded for execution by the newly 


Created task. The bound unit pathname can have an 
optional suffix in the form of ?entry, where entry 
the symbolic start address within the root segment 
If this suffix is not given, the default start add 
(established at Link time) is used. (Function cod 
0C/03.) 


FUNCTION DESCRIPTION: 


This call causes the allocation and initialization of th 
data structures that define and control task execution. 
call does not activate the task; the request task macro 
is required for task activation. 


is 
ress 
e 


e 
The 
call 


One or more create task macro ese can be issued to create 


one or more tasks within a task group. 


When a create task macro call is executed, the system bu 
a resource control table (RCT) and a task control block 
(TCB) for the created task. The address of the RCT is 


ilds 


placed in the logical resource table (LRT) in association 


with the appropriate LRN. 


Either the location of the start address or the location 
the root entry name address, but not both, can be specif 


If the new task is to execute the same bound unit as the 
issuing task, then the count of tasks associated with th 


of 
led. 


e 


unit is incremented (function code O0C/02) to prevent pre- 


mature reuse of memory containing the bound unit. 
If the specified bound unit is not a sharable bound unit 


the bound unit is loaded into memory belonging to the ta 
group. If the specified bound unit is both sharable and 


that is currently resident in memory, the root segment of 


sk 


currently resident, the count of tasks associated with the 


unit is incremented. (Function code 0C/03.) 


5-116 


CB08 


a 


NOTES: 


The LRN supplied by argument 1 is placed in S$R2; 
if this argument is omitted, SR2 is assumed to 
contain the LRN for the created task. 


The relative priority level supplied by argument 
2 is placed in $R6; if this argument is omitted, 
SR6 is set to the relative priority level of the 
task issuing this create macro call. 

Arguments 3 and 4 are mutually exclusive. If 
both are supplied, argument 3 is used and a 
diagnostic is issued. Information derived from 
either argument is placed in $B2; if these argu- 


ments are omitted, SB2 is assumed to contain the 
Start address to be used. 


On return, S$R1l and $R2 contain the following 
information: 


SR1 - Return status; one of the following: 
0000 - No error 
Olxx - Media error 
0209 - Bound unit not found 
0602 - Memory unavailable 
0809 - LRN too large 


0813 - Referenced LRN already in use or 
invalid 


0827 - Bound unit file not fixed-relative 
0830 - LRN not available 


082D - Group's available memory quota 


exceeded 
OE 02 - No memory available for nonswap- 
pable task 
1604 - Unresolved symbolic start address 
160A - Insufficient memory 


1611- Zero length root segment 
1613 - Invalid bound unit pathname 
1615 - Illegal bound unit file 
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SR2 - LRN of created task 
Examples : 


In this example, the $CRTSK macro call makes a task 
logical resource number 10 (decimal) of the issuing 


known as 
group. 


The task will execute at priority level 2 relative to the 


group's relative base level. The task will execute 


the pro- 


cedures contained in the bound unit PROG10, as found by 
application of search rules, entering the bound unit at 


entry point PROGIO. 


SCRTSK =10,=2,,!ROOT 


ROOT TEXT "PROG 104! 


In this example, the SCRTSK macro call makes a task 
logical resource number 12 (decimal) of the issuing 
The task will execute at the same priority level as 
issuing task. The task will execute the same bound 
the issuing task and will be started at the address 
sented by the label SSA. 


SCRTSK =12,,,!SSA 
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group. 
the 
unit as 
repre- 
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LK is a Semaphore which has an initial value of 1 and which 
controls access to the free resource list by serving as a 
lock. After a task has reserved the right to use a resource 
by performing the P-op on TH as described above, the task 
will unlink (the description of) a particular resource from 
the free-resource list. Upon entering a section where it 
examines or modifies the free-resource list, the task does a 
P-op on the semaphore LK, thus ensuring the integrity of 
this data base. After it stops using this data base, the 
task does a V-op on LK. 


When the task finishes uSing the resource, it will return 
the resource by doing a P-op on LK, linking (the description 
of) the resource being returned into the free-reSource 1iSt, 
doing a V-op on LK, and then doing a V-op on TH. 

DEFINE SEMAPHORES TO CONTROL RESOURCES 


SDFSM = TH 3=10 
SDFSM ="LK! 


ROUTINE TO GET A RESOURCE 

FIRST GET RIGHTS TO TAKE A RESOURCE 
SRSVSM = ='TH' 

NOW LOCK THE FREE RESOURCE LIST 
SRSVSM = "EK" 


TAKE A RESOURCE FROM THE FREE RESOURCE LIST 


THEN UNLOCK THE FREE RESOURCE LIST 
SRLSM ="LK" 

END OF ROUTINE TO GET A RESOURCE 

ROUTINE TO RETURN A RESOURCE 

FIRST LOCK THE FREE RESOURCE LIST 


SRSVSM  ='LK! 
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NOW LINK THE RESOURCE BACK INTO THE FREE RESOURCE LIST 


THEN UNLOCK THE FREE RESOURCE LIST 


SRLSM ="LK' 
FINALLY RELEASE THE RESOURCE 


SRLSM ='TH' 


END OF ROUTINE TO RETURN A RESOURCE 
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, DELETE DIRECTORY 


DELETE DIRECTORY 

Macro Call: SDLDIR 

Function Code: 10/A5 

Equivalent Command: Delete Directory (DD) 


Deletes a previously created directory from the system; all 
of the directory's attributes, including its name, are 
removed from the immediately Superior directory that 
describes it, and all space allocated to the directory is 
released. This function is usually done outside program 
execution. 


FORMAT: 


{ [label] SDLDIR [argument structure address] 
| ARGUMENT DESCRIPTION: 


argument structure address 


Any address form valid for an address register; pro- 
vides the location of the parameter structure defined 
below. The parameter structure must contain the 
following entry. | 


pathname pointer 


A 4-byte address, which may be any address form 
valid for an address register; points to a path- 
name (which must end with an ASCII space char- 
acter) that identifies the directory to be 
released. 
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FUNCTION DESCRIPTION: 


o™ 
This macro call, in effect, reverses the create directory Na! 
action, provided it has no subordinate directories or files 
(i.e., if the directory to be released contains a subordi- 
nate directory or file it is not released and an error code 
is returned). In addition, if it is currently the working 
directory in any task group, the directory cannot be 
released. 
NOTES: 1. If the argument is coded, the address of the 
parameter structure is loaded into $B4; if the 
argument is omitted, $B4 is assumed to contain 
the address of the parameter structure. 
2. On return, S$R1 contains one of the following 
status codes: 
0000 Successful completion 
Olxx Physical I/O error 
0201 Illegal pathname 
0202 This function requires a pathname to be 
specified 
0205 Tllegal argument i 
0209 - Named directory not found 
020C Volume not found 
0213 Cannot provide requested concurrency 
0220 Attempted deletion of nonempty directory 
0222 Pathname cannot be expanded, no working 
directory 
0225 Not enough system memory for buffers or 
structures 
0226 Not enough user memory for buffers or 
structures 
0228 Tllegal file type (not a directory) 
022C Access control list (ACL) violation 
7/79 : 
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Example: 


In this example, the $DLDIR macro call deletes the directory 
created in the create directory example (i.e., SUBINDEX.A). 
The system uses the first entry to identify the directory to 
be deleted. The delete directory macro call is coded as: 


SUBDIR DC <DIRPTH 
DIR PTH DC '“*VOL03>SUBINDEX.AA' 
SRLDIR !SUBDIR 
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DELETE FILE 


DELETE FILE 
Macro Call Name: SDLFIL 


Function Code: 10/35 
Equivalent Command: Delete File (DL); RL usable also in MOD 600 


Delete a previously created file from the system. All the 
file's attributes, including its name, are removed from the 
directory that describes it, and all space allocated to the 
file is released. You identify the file to be deleted by 
supplying either a logical file number (LFN) or a pathname. 
This function is usually done outside program execution. 


FORMAT: 


[label] SDLFIL [argument structure address] 
ARGUMENT DESCRIPTION: 


argument structure address 


Any address form valid for an address register; pro- 
vides the location of the argument structure defined 
below. The argument structure must contain the fol- 
lowing entries in the order shown. 


logical file number 


A 2-byte logical file number (LFN) used to refer 
to the file; must be a binary number in the 
range 0 through 255; or blank (which indicates 
that an LFN is not specified). 


pathname pointer 


A 4-byte address, which may be any address form 

valid for an address register; points to a path- 

name (which must end with an ASCII space char- 

acter) that identifies the directory in the file 
hierarchy in which the file to be released is 

found (as well as the name of the file itself). —_ 
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Zeros in this entry indicate that a pathname is 
not specified. 


FUNCTION DESCRIPTION: 


This macro call, in effect, reverses the create file action, 
provided the file is neither open in this task group, nor 
reserved by another task group. In the case of the former, 
a return status code of 0208 is loaded in SRl; in the latter 
case, the file is deleted after the other task group is 
finished using it. 


The file to be deleted can be specified by (1) an LFN only, 
or (2) a pathname only. If only an LFN is specified, the 
file must have been created or reserved (through a create 
file or get file macro call, or equivalent command) with 
that LFN. 


For files other than disk files, the delete file function is 
equivalent to the remove file function. 


NOTES: 1. If the argument is coded, the address of the 
argument structure is loaded into $B4; if the 
argument is omitted, $B4 is assumed to contain 
the address of the parameter structure. 


nN 
e 


On return, SR1 contains one of the following 
status codes: 


0000 — No error 
Olxx - Physical I/O error 
0201 - Illegal pathname 


0202 - The LFN and pathname both were not 
specified 


0205 - Illegal argument 
0206 - Unknown or illegal LFN 


0208 - LFN or file currently open in same task 
group 


0209 - Named file or directory not found 
020C - Volume not found 


0210 —- LFN conflict 
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0222 


0225 


0226 


0228 
022C 


Example: 


Pathname cannot be expanded, no working 
directory 


Not enough system memory for buffers or 
structures 


Not enough user memory for buffers or 
structures 


Illegal file type (a directory) 


Access control list (ACL) violation 


In this example, the macro call deletes the file created in 
the create file macro call example. To do this, it refer- 

ences the same argument structure as the S$CRFIL macro call; 
the system, in turn, uses the first two entries to identify 
the file to be deleted. The delete file macro call is 


coded aS: 


SDLFIL !FILE_A 
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KEY 


Indicates that the record identified by the key value 
pointed to by the FIB is to be deleted. You must code 
the following FIB entries: 


logical file number 
input key pointer 
input key format 


FUNCTION DESCRIPTION: 


Before this macro call can be executed, the file must have 
been opened (see the open file macro call) with a program 
view word that allows access via data management (bit 0 is 
0) and allows delete operations (bit 4 is 1). The file must 
have been reserved (see get file macro call) with write 
access concurrency (type 3, 4, or 5). In addition, execu- 
tion of this macro call has no effect on the next read or 
write pointer (i.e., it can be issued between a read next 
record and write next record macro call without disturbing 
the sequence of the records being read or written). 


The delete record macro call does not apply to fixed- 
relative files with nondeletable records, tape files, and 
device files. 


The file information block can be generated by a S$FIB macro 
call. Displacement tags for the FIB can be defined by the 
SFIBDM macro call. 


NOTES: 1. If the argument is coded, the address of the FIB 
is loaded into $B4; if the argument is omitted, 
SB4 is assumed to contain the address of the 
FIB. 


2. None of the out-values in the FIB are set by 
this macro call. 


3. On return, SR1 contains one of the following 
Status codes: 


0000 - No error 

Olxx - Physical I/O error 
0203 - Illegal function 

0205 - Illegal argument 

0206 - Unknown or illegal LFN 
0207 - LFN not open 

O20A - Address out of file 
O20E - Record not found 


0217 - Access violation 
0219 - No current record pointer 
O21E - Key length or location error 
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O22A - Record lock area SUeEE LOW: 


022B - Requested record is locked or causes 
deadlock 


O22F - Unknown or illegal record type 
0237 - Invalid record or control interval format 


Example: 


The macro call in this example identifies the FIB that is 
described under "Assumptions for File System Examples" in 
Section 3. The STFIB macro call reserved the FIB tags. The 
SDLREC macro call indicates that the current record is to be 
deleted; it is assumed that the file is open and that a 
SRDREC NEXT (read next record) macro call immediately 
precedes the SDLREC macro call. The macro call is: 


SDLREC IMYFIB,CURRENT 


The FIB identified by the address in the first argument is 
as defined in the example for the open file macro call. In 
addition, offset tags can be used to access the LFN in later 
instructions in your program with the macro call STFIB. 
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or 


DELETE SEMAPHORE 


DELETE SEMAPHORE 

Macro Call Name: S$DLSM 
Function Code: 06/07 
Equivalent Command: None 


Delete a counting semaphore that is currently defined for 
the task group issuing this call. 


FORMAT : 


[label] SDLSM [location of semaphore identifier] 


ARGUMENT DESCRIPTION: 
location of semaphore identifier 


Any address form valid for a data register; provides 
the semaphore identifier, as two ASCII characters, of 
the semaphore to be deleted. 


FUNCTION DESCRIPTION: 


This call deletes a counting Semaphore that was previously 
defined for the issuing task group with a define semaphore 
(SDFSM) macro call. 


The semaphore will be deleted only when there are no tasks 
waiting for the resource controlled by the semaphore (see 
reserve semaphore (SRSVSM) macro call). If tasks are wait- 
ing, a return to the issuing task results, with SR1l contain- 
ing a 0504 status code. When there are no longer any tasks 
waiting on the semaphore, the SDLSM macro call must be 
reissued. 


When the semaphore is deleted, all system references to it 


are removed. An attempt to use it results in a return to 
the issuing task, with status code 0502 in SRl. 
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NOTES: 1. The semaphore identifier supplied by the argu- 
ment is placed in SR6. When the argument is 
omitted, the system assumes that $R6 contains 
the identifier to be used. 


2. On return, registers $R1l and SR6 contain the 
following: 


$Rl1 - Return status; one of the following: 
0000 - No error 
0502 - Semaphore not defined 


0506 - Semaphore is currently active and 
cannot be deleted. 


SR6 - Semaphore identifier (as supplied) 
Example: 
The issuing task group requests that semaphores TH and LK 


(as defined for the example given in the define semaphore 
(SDFSM) macro call), be deleted. 


DLSAA SDLSM ='"TH' 
CMR $R1,=Z'0504' 
BE TH BSY 

DLSBB SDLSM ="LK ! 
CMR | SR1,=2'0504' 
BE LK BSY 
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ENABLE USER TRAP 


ENABLE USER TRAP 
Macro Call Name: SENTRP 
Function Code: 0OA/0l 
Equivalent Command: None 
Enable a specified user trap for the issuing task. 
FORMAT: 
[label] SENTRP [location of trap number] 
ARGUMENT DESCRIPTION: 
location of trap number 


Any address form valid for a data register; provides 
the trap number of the trap to be enabled. The trap 
number is a decimal value from 0 through 63, or a 
value of -l. A -1 value designates that all user 
traps are to be enabled. 


FUNCTION DESCRIPTION: 


This call causes a specific hardware trap vector whose 
number is derived from argument 1 to be enabled. All subse- 
quent occurrences of the specified trap cause control to be 
transferred to a previously established trap handling rou- 
tine for the task (see connect trap handler macro call). 


When the task group's general trap handling routine is 
entered, $R3 contains the trap number assigned to the event 
that caused the entry to the routine. $B3 contains the 
location of the trap save area. The j-mode bit in the I- 
register has been set off. All other registers are 
unchanged. An RTT (return from trap) instruction is exe- 
cuted to return from the task's trap handler. (See Section 
7 for more information about trap handling.) 


et CB08 


NOTES: 1. The trap number of the trap to be enabled, sup- a . 
eg BG plied by argument 1, is placed in S$R2; if this ed 
argument is omitted, SR2 is assumed to contain 

the binary number of the trap to be enabled. 


2. On return, SR1 and $R2 contain the following 
information: 


SR1 - Return status; one of the following: 


0000 


No error 


0341 - Trap handler entry not connected 


0342 - Illegal trap number (requested trap 
not a user class trap). 
SR2 - Trap number supplied in macro call 


3. This macro call is required in order to enable a 
software simulated trap in a task that the user 
interrupts with the break key function, and for 
which a PI or UW break response is entered. 


Example: 


See the example given for "Trap Handler, Connect." 


4 
oe ade 
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ENTRY POINT IDENTIFICATION 


ENTRY POINT IDENTIFICATION (MOD 600 ONLY) 
Macro Call Name: SENTID 

Function Code: 14/07 

Equivalent Command: None 


MOD 400 returns the address or value corresponding to a 
specified symbolic name which has been specified in an EDEF 
statement within the bound unit currently being executed by 
the issuing task, or within a bound unit made permanently 
resident by a CLM LDBU statement. For MOD 600, the cur- 
rently executing bound unit is searched followed by a search 
of all other attached bound units. 


FORMAT: 


[label] SENTID [location of symbolic name field address], 
[location of id type] 


ARGUMENT DESCRIPTION: 

location of symbolic name field address 
Any address form valid for a data register; provides 
the address of an aligned character string that con- 
tains the symbolic name. The name must have been 
declared at link time in an EDEF statement. 


location of id type 


Any address form valid for a data register; provides 
the id type. 


FUNCTION DESCRIPTION: 
The call returns to the issuing task, in $B2, the entry 


point address or, in $R2, the overlay id corresponding to 
the symbolic name specified in the macro call. 
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Example: 


The address of the symbolic name field supplied 
by argument 1 is placed in $B4. When this 
argument is omitted, the system assumes that $B4 
contains the field's address. 


If "A" (address) is specified in argument 2, $R6 


is loaded with 0. If "V" (value) is Specified i 
in argument 2, $R6 is loaded with -l1. If argu-e 
ment 2 is omitted, the system assumes that SR6 c 
contains the id type. 


On return, SR1l, $R2, and $B2 contain the 
following: 


SRl - Return status, one of: 
0000 - No error 


080C - Symbolic name not found; unresolved 
symbolic start address 


0817 - Memory access violation 
SR2 - Value definition (if $R6=-1 on input). 
$B2 - Entry point address corresponding to the 


specified symbolic name (if $R6=0 on 
input). 


The issuing task obtains the entry point address correspond- 
ing to the symbolic name ENTRY1. The address is returned to 
$B2, not stored in memory. 


SENTID ! ENTNAM, =6 


ENTNAM TEXT "ENTRYL' 
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Pages 147 through 165 have been deleted 


5-147 
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ERROR OUT 


ERROR OUT 

Macro Call Name: SEROUT 
Function Code: 08/03 
Equivalent Command: None 


Write the next record to the error-out file for the task 
group of the issuing task. 


FORMAT: 


[label] SEROUT [location of record area address], 
[location of record size], 
[byte offset from beginning of record area] 


ARGUMENT DESCRIPTION: 
location of record area address 


Any address form valid for an address register; pro- 
vides the address of a record area containing the 
record to be written to the error-out file. The first 
byte of the record must be a Slew byte (print file 
form control byte; see "Printer Driver" in Section 6). 
The record text begins in the second byte. 


location of record size 
Any address form valid for a data register; provides 
the size (in bytes) of the record whose address is 


given in argument 1. The output size value must 
include the slew byte. 
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EXPAND PATHNAME 


EXPAND PATHNAME 
Macro Call Name: SXPATH 
Function Code: 10/D0 
Equivalent Command: None 
Develop a full pathname from a relative pathname. 
FORMAT: 
[label] SXPATH fargument structure address] 
ARGUMENT DESCRIPTION: 
argument structure address 
Any address form valid for an address register; pro- 
vides the location of the argument structure defined 
below. The argument structure must contain the fol- 
lowing entries in the order shown. 
input pathname pointer 
A 4-byte address, which may be any address form 
valid for an address register; points to a 
relative pathname (which must end with an ASCII 
Space character) to be expanded. 
output pathname pointer 
A 4-byte address, which may be any address form 
valid for an address register; identifies a 58- 
byte field into which the absolute (i.e., 
expanded) pathname is placed by the system. 
pathname base 
A 2-byte binary value that specifies the basis 


on which to expand the relative path, as 
follows: 
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0000 - Working directory 
0001 - System library-1l 
0002 - System library-2 


FUNCTION DESCRIPTION: 


This macro call will expand any relative pathname, regard- 
less of the format in which it is supplied, into an absolute 
pathname. It is possible that the resulting pathname will 
point to a nonexistent file. The expanded pathname cannot 
exceed 58 characters. 


NOTES: 1. If the argument is coded, the address of the 
argument structure is loaded into $B4; if the 
argument is omitted, $B4 is assumed to contain 
the address of the argument structure. 


2. On return, S$R1 contains one of the following 
status codes: 


0000 - Successful completion 
0201 - Illegal pathname 
0202 - Pathname not specified 
0205 - Illegal argument 


0222 - Pathname cannot be expanded, no working 
directory | 


Example: 


In this example, the pathname of the working directory is 
“VOL6 >SUB1 >SUB2 >SUB3 >SUB4, and you want to develop a fully 
expanded absolute pathname from the relative pathname<<ADF. 
In the macro call, you must identify the relative pathname 
(<<ADF) and the basis (working directory) on which the 
absolute pathname is to be developed, as well as an area 
into which the system can place the fully expanded absolute 
pathname. The main memory area is defined as follows: 


X NAME RESV- 29 


The argument structure is built as follows: 


XPND 1 DC <RELPTH. 
RESV 2-SAF,0 
DC <X_NAME 
RESV 2-SAF,0 

DC 0 
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1. 


Re 


structure for Storage Management Access: 


Logical File Number (LFN) 


= 
a [eseeer roneten) size 
7 
8 


Block Size 


Block Number 


Reserved 


Reserved fields must be 
set to zeros to ensure 
compatibility with later 
versions of this 
structure. 


Generated Offsets Tags: 


Tag 


F_LFN 
F PROV 
F URP 
F IRL 
F ORL 
F IKP 
F IKF 
F IKL 


(in Words) 


Corresponding 


Offsets 


Entry Name 


Logical file number (LFN) 


+] Progam view 
+2 User record pointerl 
+4 Input record lengthl 
+5 Output record lengthl 
+9 Input key pointerl 
Input key format (first byte)l 


Specific to SRDREC, SWRREC, $RWREC, and $DLREC macro calls. 


Specific to SRDBLK, and SWRBLK macro calls. 


ol S7 


Input key length (Second byte)1l 


CBO08 


Corresponding 


Offsets 

Tag (in Words) Entry Name 
F ORA +12 7 Output record addressl 
F ORAI F ORA(+12) (left half of F ORA)1 
F ORA2  F ORA+1 (+13) (right half of F ORA)1 
F UBP +2 User buffer pointer2 
F BFSZ +4 Buffer size2 
F BKSZ +5 Block size2 
F BKNO +6 Block number2 
F-BKN1  F_ BNKO(+6) (left half of F_BKNO) 
F BKN2  F_BKNO+1 (+7) (right half of F BKNO) 
F SZ 16 Size of structure (in words) ; 


In addition to the offsets tags listed above, 


not a field in the block 


the following 


program view (F PROV tag, above) masks are defined: 


Tag Mask Meaning 

MF OPS Z'8000' Open for storage management 

MF RDA Z'4000' Read operations allowed 

MF WRA Z'2000' Write operations allowed 

MF RWA Z'1000' Rewrite operations allowed 

MF DLA Z'0O800' Delete operations allowed 

MF PKA Z'0400' Access via primary key 

MF RKA 2Z'0080' Access via relative key 

MF SKA Z'0040' Access via Simple key 

MF FRA Z'0020' Fixed length records allowed 

MF DLV Z'0010' Deleted records visible to program 

MF KOD Z'0008' Key area starts an odd-byte boundary 

MF ROD Z'0004' Record area starts at odd-byte boundary 
7 (data management specific) 

MF BOD Z'O0004' Buffer area starts at odd-byte boundary 
i (storage management specific) 

MF BTM Z'0002' Data transferred in binary 

transcription mode 
MF AIO Z'OOO1' Next block function is asynchronous 


(Storage management specific) 


1. Specific to SRDREC, SWRREC, SRWREC, and SDLREC macro calls. 


2. Specific to S$RDBLK, and SWRBLK macro calls. 
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Example 1: 


0209 


Named file or directory not found 


020C Volume not found 

0211 Unable to establish a unique LFN 

0213 Cannot provide requested file concurrency 

0222 Pathname cannot be expanded, no working 
directory 

0225 Not enough system memory for buffers or 

| structures 

0226 Not enough user memory for buffers or 
structures 

O22A Record lock area overflow or not defined 

022C Access control list violation 

022E Recovery/record lock concurrency conflict 

0238 Invalid file description 


In the following example, the get file macro call identifies 
an argument structure that contains the appropriate argu- 
ments to reserve the indexed file created in the example for 
the create file macro call (i.e., FILE A) with type 5 con- 
currency control 
argument structure was built as follows: 


WRTFIL 


(read/write share) and record locking. The 


Z‘'OOO5' See "Assumptions for File 


System Examples" in Section 3. 
(The pathname is defined in 
the example for the create 
file macro call.) 


DC <IDXO1 
RESV 2-SAF 
DC Z'8501' READ/WRITE SHARE; RECORD 
LOCKING: ISSUE MOUNT REQUEST 
RESV 2,0 IGNORED 
DC Z‘'0O200 BUFFERS=2 
RESV 4,0 IGNORED 
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It is assumed that the following macro calls were issued 
before the SGTFIL macro call was issued: on 


SCRDIR !SUBDIR (See create directory macro example) 


SCRFIL IFILE A (See “Assumptions for File System 
Examples") 


The $GTFIL macro call altering FILE A concurrency from 
excluSive to share can be Specified as follows: 


SGTFIL: !WRTFIL 
Example 2: 


In this example, the S$GTFIL macro call is used to append 
characters to an incomplete pathname defined as follows: 


DIRPTH DC "A VOLO3>SUBINDEX.AA! (See create direc- 
tory macro example) 


This pathname has been asSociated with the LFN as follows: 
SASFIL !FILE X 


where the argument structure labeled FILE X has been defined 
as follows: 7% 


FILE X DC Z'OOA3' LFN=163 | 
DC <DIRPTH  PATHNAME '(\yoL03 SUBINDEX.AA! 
RESV  2-SAF 


Assuming that the above definitions have been made, the 
following argument structure identifies the characters to be 
appended to the incomplete path (DIRPTH): 


WTFIL2 DC Z‘'OOA3' LFN=163 
DC <IDXO02 PATHNAME POINTER 
RESV 2-SAF 
DC Z'O301' EXCLUSIVE: ISSUE MOUNT REQUEST 
RESV 2,0 UNSPECIFIED 
DC Z'0200' BUFFERS=2 
RESV 4,0 IGNORED 


The pathname labeled IDX02 is defined as follows: 


IDX02 DC '; FILE CA‘ 
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fille, 


Peripheral Device 


Line Printer 


Magnetic Tape 


*logical resource number 


*file 


Device 
Type 
Code 


Marketing Identifier 


PRU9104/9106 
Same as above but with 
Option PRF9102 
PRU9103/9105 

same as above but with 
Option PRF9102 


MTU9104 
45-ips) 
MTU9105 
75-ips) 
MTU9109 


bpi, NRZI, 


MTU9109 
bpi PE, 


(9-track, 
45-ips) 
(9-track, 
45-ips) 


MTU9110 (9-track, 


bpi NRZI, 


MTU9110 
bpi PE, 


75-ips) 


(9-track, 
75-ips) 


MTU9112 (7-track, 


bpi) 


MTU9112 (7 


bpi) 


-track, 


MTU9113 (7-track, 


bpi) 
MTU9113 
bpi) 
MTU9114 


(7-track, 


(9-track, 


bpi, 45-ips) 


| MTU9115 (9-track, 
bpi, 75-ips) 


(9-track NRZI, 


(9-track NRZI, 


800 

1600 
800 

1600 
556- 
800- 
5560> 
800- 
1600 


1600 


A 2-byte entry into which the system places the 
logical resource number (LRN) that corresponds 
to the device on which the specified file is 


located. 


type 


A l1-byte entry into which the system places a 
code identifying the file organization of the 
specified file, as follows: 


a2 20 


CBO08 


PHMAHNDWUUW NWO FH 
! 


- IBM diskette 

- Device file | a™ 
- Fixed-relative without deletable records ve, 
-~ Fixed-relative with deletable records 

Directory 

- Relative 

- Sequential 

- Indexed 

~ Random (calc) disk file 

- Tape-resident file 


*data format 


A l-byte entry into which the system places a 
code identifying the format of the data, as 


follows: 

F - Fixed-length record 

D —- Variable-length record (decimal count size) 
V - Variable-length records (binary count size) 
U - Undefined 


file attribute pointer 


A 4-byte address of a 32-byte field in main 

memory into which the system can place file- 

attribute information, as described below; may fs 
be any address form valid for an address regis- LY 
ter or zeros, which indicate that the informa- - 
tion is not required. 


reserved 
A 4-byte entry, containing zeros. 
key descriptor pointer 


A 4-byte address of an 18-byte field in main 
memory into which the system can place key- 
descriptor information, as described below; may 
be any address form valid for an address regis- 
ter, or zeros, which indicate that the informa- 
tion is not required. 


reserved 
A 4-byte entry, containing zeros. 
The system places file attribute information in the 32-byte 
field pointed to by the file attribute entry described 
above. For disk-resident files, the structure contains the 


following: es 


7/79 
5-222 oo CBO08-02A 


*block size 


A 2-byte entry specifying the maximum size (in 
bytes) of a physical record (i.e., the unit of 
transfer to a device file). 


*reserved 


A 28-byte entry containing zeros. 


The following key descriptor information is placed in the 
18-byte field pointed to by the key descriptors entry 


described above. This structure applies only to indexed 
files, and contains the following: 


*reserved 


A 4-byte entry that contains zeros. 
*number of key components 


A l-byte entry that contains l. 


*reserved 


A 9-byte entry that contains zeros. 


*key component data type 


A l-byte entry that indicates the data type of 
the key component. The entry is hexadecimal 43 


(i.e., C) for character, or hexadecimal 44 
(i.e., D) for decimal. 


*key component size 


A l-byte entry that specifies the size of the 
key component in bytes; that is, it specifies 
the size of the primary key stored in each 
logical record in the indexed file. 


*key component location 


A 2-byte entry that specifies the offset (in 
bytes) from the beginning of the record to the 
beginning of the key field; the first byte in 
the logical record is position l. 


FUNCTION DESCRIPTION: 


Before this macro call is issued, tape-resident files must 
be open (see the open file macro call) so that the system 
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can retrieve the file attribute information. (File attri- 
bute information is stored in the tape labels.) 


If neither the pathname nor the LFN is specified, a status 
code of 0205 is returned. 


If an, LFN is specified, the file must have been previously 
reserved through that LFN via a get file or create file 
macro call (or equivalent command). 


To access specific entries in the argument structure, use 
the SGIPSB, SGIKDB, and SGIFAB macro calls. 


NOTES: 1. If the argument is coded, the address of the 
argument structure is loaded into $B4; if the 
argument is omitted, $B4 is assumed to contain 
the address of the parameter structure. 


2. On return, $R1 contains one of the following 
status codes: 


0000 - No error 

Olxx - Physical I/O error 

0201 - Illegal pathname 

0202 - Pathname not specified 

0205 - Illegal argument 

0206 - Unknown or illegal LEN 

0209 - Named file or directory not found 
020C —- Volume not found 


0222 —- Pathname cannot be expanded, no current 
working directory 


0225 - Not enough system memory for buffers or 
structures 


0226 —- Not enough user memory for buffers or 
structures 


0228 - Illegal file type 
022C - Access control list (ACL) violation 
O22E - Record lock concurrency conflict 


0238 - Invalid file description 
| 7/79 


5-226 | CBO08-02A 


po 


Structure for Disk Files: 


es ee 
Ta [eonteor snterval size 
Ta [everene ahosstion sine 
Ta [mnocation increnene 
a [ nesinum attocation size 
a 
a 
= 


Free Space per Control Interval 
Local Overflow Increment 
nambee of Key Descriptors 


Reserved 


Reserved fields must be set to 
zeros to ensure compatibility 
with later versions of this 
structure. 


Generated Offsets Tags: 


For tape-resident and device files: 


Corresponding 


Offsets 
Tag (in words) Entry Name 
T LRSZ 0 Logical record size 
T BKSZ +] Block size 
T RFU +2 Reserved 
T SZ 16 Size of structure (in words); 


not a field in the block 
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For disk-resident files: 


Tag 


K_LRSZ 
K_CISZ 
K CASZ 


Corresponding 
Offsets 


(in words) 


0 
+] 
+2 
+3 
+4 
+5 
+6 
+7 


16 


Entry Name 


Logical record size 


Control interval/physical sector size 


Current allocation size 
Allocation increment size 
Maximum allocation size 
Amount of free space per C.I. 


Local overflow allocation increment 


Number of keys 


Size of structure (in words); 
field in the block 


If the tape file sequence number is 00 and 


not a 


1. The file is opened at a storage management (block) 


level and, 


2. No volume name or file name has been given in the 


pathname, 


the tape is reserved for volume (device) level access. 
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GET WORKING DIRECTORY 


GET WORKING DIRECTORY 


Macro Call Name: SGWDIR 
Function Code: 10/C0O 
Equivalent Command: List Working Directory (LWD) 


Returns the name of the current working directory. This 
function is usually done outside program execution. 


FORMAT: 

[label] SGWDIR [argument structure address] 
ARGUMENT DESCRIPTION: 
argument structure address 


Any address form valid for an address register; pro- 
vides the location of the argument structure defined 
below. The argument structure must contain the fol- 
lowing entry. 


working directory pathname 


A 45-byte field, in main memory, into which the 
system can place the full absolute pathname of 
the current working directory. 


FUNCTION DESCRIPTION: 


This macro call returns the full absolute pathname of your 
Current working directory. Although the pathname may be 
Shorter than the maximum 45 characters, the argument struc- 
ture must be large enough to accommodate the maximum number 
of characters. 


NOTES: 1. If the argument is coded, the address of the 
argument structure is loaded into $B4; if the 
argument iS omitted, $B4 is assumed to contain 
the address of the argument structure. 
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2. On return, $R1 contains one of the following 
Status codes: co 


0000 - No error | ed 
0205 - Illegal argument 


0222 - Pathname cannot be expanded, no working 
directory 


Example: 


This example assumes the following file system hierarchy 
(see the System Concepts manual) and that the working direc— 
tory is ‘'SUB.DIR.BBIL". 


VOLO1 
SUB.DIR.A SUB.DIR.B 
| 
SUB.DIR.AA FILEO1 SUB.DIR.BB 
| a. 
FILEO2 FILEQO3 SUB.DIR.BB1 


| | 
FILEO4 SUB.DIR.B1B 
| 


FILEOS _ 


Coding the SGWDIR macro call causes the system to place the 
full absolute pathname of the working directory, defined 
below, into the specified argument structure: 

SGWDIR {CURDIR 

CURDIR RESV 29 


The path placed in the main memory field labeled CURDIR is: 


“VOLO1>SUB.DIR.B>SUB.DIR. BB>SUB. DIR. BBLAAAAAA 


7/79 
5-242 CB08-02A 


GROUP STATUS 
(MOD 600) 


GROUP STATUS (MOD 600 ONLY) 
Macro Call Name: S$GRPST 
Function Code: 14/05 


Equivalent Command: None 


Return the current status information about the specified | 
group to a 47-word receiving field. 7 


FORMAT : 
[label] SGRPST [location of group id whose status is requested], 
[location of group-status field address] 


ARGUMENT DESCRIPTION: 


location of group id 


Any address form valid for a data register; provides 


the group id of the task group whose status is to be 
returned. 


location of group-status field address 


Any address form valid for a data register; provides | 
the address of a 47-word nonvarying receiving field Fa 


where the system will place current status information 
about this task group. 


FUNCTION DESCRIPTION: 


This call returns to the issuing task, in S$B4, the address 
of the 47-word receiving area that will contain the status aq 
information, in the following order, formatted as follows: 
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Number 
of Words 


3 


16 


NOTES: es 


Contents 


Terminal id (in ASCII) associated with this 
group as primary logon; blank if applicable 


User id (in ASCII) associated with this task 
group 


Group id (in ASCII) 
Reserved for system use 
Amount of CP time used 
Private memory total 
Shared memory total 
Status of pre-emption and load control 
I/O count 
segment Swap count 
Overlay miss count 
Overlay hit count 
Last bound unit loaded by create task 
Size of group status block 
The location of the group id supplied in 
argument 1 is placed in $R2. When this argument 
is omitted, the system assumes that $R2 contains 
the location of the group id. 
The address of the 47-word receiving field sup- 
plied in argument 2 is placed in $B4. When this 
argument is omitted, the system assumes that SB4 
contains the receiving field's address. 
On return, SR1 and $B4 contain the following: 
SR1 - Return status codes, one of: 
0000 - No error _ 
0817 - Memory access violation 
0818 - oe task group with specified group 
i 
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—_ 


Example: 


SB4 - Address of the group-status receiving 


field 


This macro call obtains group status information about the 


task group whose id is JR, 


47-word field labeled STATUS: 


JRSTAT 


STATUS 


SGRPST 


RESV 


="JIR',!STATUS 
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and places the information in the 
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HOME DIRECTORY © 


HOME DIRECTORY 

Macro Call Name: SHDIR 

Function Code: 14/0B 

Equivalent Command: Home Directory (HOME DIR) 


Return the pathname of the initial working directory of the 
calling task group to a 45-character receiving field. 


FORMAT : 

[label] SHDIR [location of home directory field address] 
ARGUMENT DESCRIPTION: 

location of home directory field address 


Any address form valid for an address register; pro- 
vides the address of a 45-character, aligned, non- 
varying field into which the system will place the 
pathname of the default working directory of the 
calling task group. 


FUNCTION DESCRIPTION: 


This call returns the pathname of the initial working 
directory to a field in the issuing task. The pathname 
returned is that specified in the -HD argument of the login 
command. If the -HD argument was not specified, the path- 
name returned is that set according to user registration 
arguments or system defaults. 


NOTES: 1. The address of the receiving home directory 
field, supplied by argument 1, is placed in $B4; 
if this argument is omitted, $B4 is assumed to 
contain the correct address. 


2. On return, SR1 contains one of the following 
Status codes: 


0000 - No error ~ 
0817 - Memory access violation ‘a 


eral 
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NWAIT - Do not suspend the issuing task (Set the w-bit 
to 1) 


If this argument is omitted, the value NWAIT is 
assumed. 


If WAIT is specified, argument 3 (issuing task termi- 
nation action) must be omitted. 


issuing task termination action 


One of the following values is specified to indicate 
the action to be taken upon the completion of the 


request. 
SM=aa - Do not Suspend the issuing task; release 
(V-op) the semaphore identified by aa (two 
ASCII characters), when requested task is 
completed. 
RB=label - Do not Suspend the issuing task; issue a 


request for the request block identified by 
label, when requested task is completed. 


If this argument is omitted (or argument 2 is WAIT), 
the generated IORB contains no termination option. 


( buffer address 


Address of a buffer area to be uSed for input/output 
transfers involving the specified device. If this 
argument is omitted, the buffer address field in the 
generated IORB is initialized to zeros. 


buffer byte alignment 


A value specifying the beginning byte of the buffer, 
as follows: 


R - Buffer begins in right byte of word address 
specified by argument 4 


L - Buffer begins in left byte of word address 
specified by argument 4 


If this argument is omitted, a value of L is assumed. 


buffer range 


A value specifying the length, in bytes, of the buf- 
fer. If this argument is omitted, the generated 
( IORB'sS range value is initialized to zero. 
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extension indicator 


The following value, when specified, indicates that 
the IORB is to be extended beyond the standard IORB. 
The argument causes space for the IOR. extension to be 
generated, resulting in an extended IORB (see Appendix 
A). When the argument is omitted, the system gener- 
ates a standard length IORB. 


EXT - Generate an extended IORB 
FUNCTION DESCRIPTION: 


The input/output request block (IORB) is used as the stan- 
dard means of requesting a physical I/O service. The IORB 
contains an LRN which identifies the I/O device being 
addressed. The IORB also identifies the location and size 
of the buffer to be used for physical I/O transfers as well 
as the specific function requested. 


NOTE: This macro call cannot be used in programs written in 
SAF/LAF independent code (SLIC). See the Assembly 
Language Reference manual for more information about 
SAF/LAF independent code. 


SA a ened 
ae 
—— 


Example: 


NN ee Tn 


In this example, the SIORB macro call generates a standard 
IORB having an LRN of O, a WAIT status indicating that the 
requesting task will wait for I/O completion, and a label 

(DBUF) that gives the location of the 140-byte buffer area. 


CONIO SIORB  O,WAIT,,DBUF,,140 
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ee 


0000 -— No error 
@ 0802 - Invalid LRN 


Example: 


The issuing task issues a SKILLT macro call to abort another 
task (whose LRN is 34) in the same task group. 


ABT 34 SKILLT =34 
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MESSAGE GROUP, ACCEPT 


MESSAGE GROUP, ACCEPT 
Macro Call Name: SMACPT 
Function Code: 15/01 
Equivalent Command: None 


Establish a message connection, through a mailbox, between 
an initiator's task group and the acceptor (calling) task 
group issuing this SMACPT macro call. 


FORMAT: 

[label] SMACPT [location of MGIRB address] 
ARGUMENT DESCRIPTION: 
location of MGIRB address 


Any address form valid for a data register; provides 
the address of the message group initialization 
request block (MGIRB), which must have been Spevlousie 
generated. 


FUNCTION DESCRIPTION: 


The acceptor task group issues this macro call in order to 
accept a connection request initiated (with a SMINIT macro 
call) by the initiator task group. The SMACPT macro call 

(1) indicates that the acceptor task group wishes to receive 
a message from a named mailbox (message queue), and (2) 
opens the receive function of the message facility. (See 
the appropriate System Concepts manual for a discussion 
about the message facility.) 


NOTES: l. A mailbox must have been created before the 
macro call is issued. (See the create mailbox 
(CMBX) command in the Commands manual.) Refer- 
ence to mailbox fields when no mailbox has been 
created results in an error return. 
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Table 5-3 (cont). Argument Values for SMGCRB Macro Call 


Argument Keyword Field in] 
Position Keyword Value Argument Description MGCRB_ { 


Keyword with option | | 
Any ALIGN= Buffer byte alignment: MC_OPT 
Buffer begins in right- 
most byte of address 
Specified by BUF= 
argument. a 
L Buffer begins in left- 
(default | most byte of address 
value) specified by BUF= 
argument. | 
Any WTI= Wait test indicator (for MC WTI | 
SMRECV only): | 
WAIT Do not process request | 
until data is available. : 
| DENY Return error Status when 
| (default | there is no data 
| value) available. | 
; 


“when WAIT is specified, argument 3 must be omitted. 

bWhen this argument is omitted, or argument 3 is WAIT, the 
generated MGCRB contains no termination option. In that case, 
the user must issue a SWAIT, SWAITL, or STEST macro call. 


Enclosure level that 
delimits send or receive 
message unit. 


End-of-record. 


EOR 


EOQ 
(default 
value) 


End-of-quarantine-unit. 


EOM End-of-message. 
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FUNCTION DESCRIPTION: 


The message group control request block (MGCRB) is used for 
communication between task groups, and is the means for 
passing arguments among task groups in connection with the 
message group send (SMSEND) and message group receive 
(SMRECV) macro calls of the message facility. This macro 
call makes it possible to modify an existing MGCRB by 
generating executable instructions that use registers SR6, 
SR7, and $B5 (as appropriate). The modifying process always 
uses $B4 to point to the MGCRB. 


NOTE: This macro call cannot be used in programs written in 
SAF/LAF independent code (SLIC). See the Assembly 
Language Reference manual for more information about 
SAF/LAF independent code. 
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MESSAGE GROUP CONTROL 
REQUEST BLOCK OFFSETS 


MESSAGE GROUP CONTROL REQUEST BLOCK OFFSETS 
Macro Call Name: SMGCRT 
Generated Label Prefixes: 


MC_OS 

MC MAJ 

MC OPT 

MC_BUF 

MC_BSZ 

MC DVS/MC_REC 
MC_RSR 
MC_MRU/MC_WTI 
MC EXT — 
MC_FNC/MC_REV 
MC_MGI 

MC_LVL 

MC PCI 
-MC_VDP 

MC _TGI 

MC TSK 

MC NPI 


Appendix A describes the contents of the message group con- 
trol request block (MGCRB). 


NOTE: This macro call cannot be used in programs written in 
SAF/LAF independent code (SLIC). See the Assembly 
Language Reference manual for information about SAF/ ; 
LAF independent code. 
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- MESSAGE GROUP, COUNT 


MESSAGE GROUP, COUNT 
Macro Call Name: S$MCMG 
Function Code: 15/07 
Equivalent Command: None 


Provide a count of the number of completed mesSage groups, 
not yet "accepted" by previous SMACPT macro calls, that are 
available for processing by subSequent S$MACPT macro calls. 


FORMAT: 

[label] SMCMG [location of MGIRB address] 
ARGUMENT DESCRIPTION: 
location of MGIRB address 


Any address form valid for a data register; provides 
the address of the mesSage group initialization 
request block (MGIRB), which must have been previously 
created. 


FUNCTION DESCRIPTION: 


The sending or receiving task group may issue this macro 
call to ascertain the number of completed groups currently 
in the mailbox not yet "accepted" by earlier SMACPT macro 
calls, and available to subsequent S$MACPT macro calls. The 
mailbox is described in the MGIRB for thiS macro call (See 
Table 5-4 below). 


NOTES: 1. Referenced mailboxes must have been created 
before this macro call is issued. (See the 
create mailbox (CMBX) command in the Commands 
manual.) References to mailbox fields when no 
mallbox has been created results in an error 
return. 
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Table 5-5 (cont). Argument Values for $MGIRB Macro Call 


Argument Keyword Field in 
Position Ke yword Value Argument Description MGIRB 


Keyword only (cont) 


RES V Generates the MGIRB. ae 


Keyword with expression 


Issuing task termination? 
option: 


When requested task is 
completed, do not suspend 
issuing task; release the 
semaphore identified by 
the two ASCII characters 
aa. 


When requested task is 
completed, do not suspend 
the issuing task; issue a 
request for the request 
block identified by 
label. 
Any ADR= address | When existing MGIRB is to 
be changed (RESV omit- 
ted), specifies address 
of MGIRB to be changed. 


Initiator mailbox name: 


From 1 to 12 ASCII characters, 
blank-filled,left justified. 
Default is 12 blanks. 


Acceptor mailbox name. 


From 1 to 12 ASCII characters, 
blank-filled, left justified. 
Default is 12 blanks. 


“when WAIT is specified, argument 3 must be omitted. 


Pwhen this argument is omitted, or argument 2 is WAIT, the 
generated MGIRB contains no termination option. In that case, 
the user must issue a SWAIT, SWAITL or STEST macro call. 
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FUNCTION DESCRIPTION: 


The message group initialization request block (MGIRB) is ho 
used for communication among task groups, and is the means 
for passing argumentS among task groups in connection with 
the message group accept (SMACPT), message group initiate 
(SMINIT), and message group count (SMCMG) macro calls of the 
message facility. This macro call makes it possible to 
modify an existing MGIRB by generating executable instruc- 
tions that use registers $R6, SR7, and $B5 (as appropriate). 
The modifying process always uses SB4 to point to the MGIRB. 


NOTE: This macro call cannot be used in programs written in 
SAF/LAF independent code (SLIC). See the Assembly 
Language Reference manual for more information about 
SAF/LAF independent code. 
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MESSAGE GROUP INITIALIZATION 
REQUEST BLOCK OFFSETS 


MESSAGE GROUP INITIALIZATION REQUEST BLOCK OFFSETS 
Macro Call Name: SMGIRT 
Generated Label Prefixes: 


MI_OS 

MI MAJ 

MI OPT 

MI BUF 

MI BSZ 

MI MPD 
MI_RSR 

MI _MDE/MI_ IOP 
MI EXT 

MI _FNC/MI_REV 
MI_ MGI 

MI PCM/MI_ADT 
MI NwI 

MI NDI 

MI MBI. 

MI NWA 

MI NDA 

MI MBA 

MI QSZ 

MI CNT 

MI _TGI 

MI TSK 

MI SIP 


Appendix A describes the contents of the message group 
initialization request block (MGIRB). 


NOTE: This macro call cannot be used in programs written in 
SAF/LAF independent code (SLIC). See the Assembly 
Language Reference manual for information about SAF/ 
LAF independent code. 
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MESSAGE GROUP, 


MESSAGE GROUP, INITIATE 
Macro Call Name: SMINIT 
Function Code: 15/02 
Equivalent Command: None 


Initiate a message connection, through a previously created 
mailbox, between the initiating task group (initiator) and 
the accepting task group (acceptor). 


FORMAT: 
[label] SMINIT [location of MGIRB address] 
ARGUMENT DESCRIPTION: 


location of MGIRB address 
Any address form valid for a data register; provides 
the address of the message group initialization. 
request block (MGIRB), which must have heen previously 
generated. 


FUNCTION DESCRIPTION: 


A task group that is to send a message (initiator task 
group) to another task group must issue the SMINIT macro 
call to open the send function of the message facility. 

(See the MOD 400 System Concepts manual for a discussion 
about the message facility.) The macro routine informs the 
system that a message connection is requested in order to 
send a message, and provides the name of the initiator's 
mailbox. ~ 


NOTES: 1. Mailboxes must have been created before the 
macro call is issued. (See the create mailbox 
(CMBX) command in the Commands manual.) 


2. The system places the address of the MGIRB in 
SB4,. If the argument is omitted, the system 
assumes that SB4 contains a pointer to the oe 
a 
MGIRB. : oe 
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3. Before the SMINIT macro call is executed, the 
user must generate the MGIRB (see Table A-8) 
with the argument values shown in Table 5-6. 


Table 5-6. MGIRB Argument Values for SMINIT Macro Call 


Field in 
Argument Name and Description MGIRB Argument Value 


MI MAJ O - Synchronous; task 
(bit 9) waits until all 
specified message 
group conditions are | 
met before the macro 
call is executed. 
Asynchronous; task 
continues with other 
processing while 
checking whether the 
message group condi- 
tions have been met. 
MI_ MPD Must be 0001, indicating 
local mail facility, and 
which assumes a default 
MPD that is for one-way 
message groups. 


As shown below. 


synchronous/asynchronous 
indicator 


Indicates whether macro 
call execution is to be 
synchronous or 

asynchronous. 


message-path-description 
identifier 


Identifies one of a set of 
message path descriptions 
(MPDs) aSSociated with the 
initiator task group. The 
MPD defines the connection 
between the mailboxes. 


initiator identification 


Describes the following 
Characteristics of the 
initiator at a mailbox 
where the message group 
originates. 


address type Must be hexadecimal Ol. 


Specifies that this is 
initiator's address. 


Reserved for future use. 


MI NWI Must be OQ. | 
MI NDI Must be 0. 


Reserved for future use. 
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Table 5-6 (cont). MGIRB Argument Values for S$MINIT Macro Call 


| Field in | : 
Argument Name and Description MGIRB Argument Value 


RU AeA TTT RE IS ERT NI! (EIS GO NRTA AIR EGE SU CEES AIR ID SATO Be NSD ORT COC OMT ORE SRD STU CLAN RR eC UNE IIE 
initiator identification 
(cont) 


Must be from 1 to 12 
ASCII characters, blank- 
filled, left-justified. 


initiator mailbox name 


destination identification 


Must be from 1 to 12 
ASCII characters, blank 
filled, left justified, 
and as specified when 
the mailbox was created. 


acceptor mailbox name 


4, The SMINIT macro call is effective only for a 
— one-way connection to another task group's mail- 
box. For the other task group to send messages, 
it must create its own initiator mailbox and 
issue its own SMINIT macro call. 


5. On successful macro execution, the system 
returns the message group identifier (MI_MGI 
Field) of the "initiated" message group. A 
valid identifier is returned for all requests. 


6. On return, S$R1 contains the following return 
status codes: 


0000 -—- No error 


0C23 - Invalid message-path-description 
identifier 


0C25 - Acceptor mailbox may not be accessed 
by initiator 


0C 26 - Acceptor mailbox not known 


0C 34 User-coded reason for abnormal message 
through - group 
0c 44 


O0C62 - Normal message group termination 


7. On return, register $B4 will point to the 
application's MGIRB, which is updated according 
to the specifications in the macro call. 
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MESSAGE GROUP RECOVERY 
REQUEST BLOCK OFFSETS 


MESSAGE GROUP RECOVERY REQUEST BLOCK OFFSETS 
Macro Call Name: SMGRRT 
Generated Label Prefixes: 


MR_OS 
MR MAJ 
MR_ OPT 
MR_ BUF 
MR_ BSZ 
MR ITP 
MR_ RES 
MR_RSN 
MR EXT 
MR_FNC/MR_REV 
MR_MGI 
MR CNC 
MR_ FMT 
MR_MRU 
MR AMU 


Appendix A describes the contents of the message group 
recovery request block (MGRRB). 


NOTE: This macro call cannot be used in programs written in 
SAF/LAF independent code (SLIC). See the Assembly 


Language Reference manual for information about SAF/ 
LAF independent code. 
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MESSAGE GROUP, SEND 


MESSAGE GROUP, SEND 

Macro Call Name: SMSEND 
Function Code: 15/05 
Equivalent Command: None 


Send a specified amount of meSsage text from the initiator 
task group. Optionally, make this record and any previously 
sent records available to the receiver by declaring this 
message text aS a quarantine unit. 


FORMAT: 

[label] SMSEND [location of MGCRB address] 
ARGUMENT DESCRIPTION: 
location of MGCRB address 


Any address form valid for a data register; provides 
the address of the message group control request block 
(MGCRB), which must have been previously generated. 


FUNCTION DESCRIPTION: 


The task group that issued a S$MINIT macro call to initiate a 
message connection, issues one or more SMSEND macro calls to 
send message data via that connection. A task group sends a 
message through a named mailbox, from which the receiving 
task group obtains the message. The SMSEND macro call uses 
the same message group identifier, returned in the SMINIT 
macro call, to identify the message group. 


Text units of information sent by the sending task group 
(initiator) are in the form of records. A message is one or 
more records. Each SMSEND call sends one record, which is 
the basic unit of data exchange. Each SMSEND transmission 
points to an MGCRB that describes the buffer of message 
data. 
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2. On return, $R1 contains one of the following 
Status codes: 


0000 —- No error 
0817 - Memory access violation 


3. On return, SB4 contains the address of the 
receiving field. 


Example: 


In this example, $B4 is loaded with the address (MODFL) of a 
3-character field and the SMODID macro call is issued to 
place the mode identification of the task group in that 


field. 
MODFL RESV 2 
LAB SB 4,MODFL 
SMODID 
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NEW COMMAND _IN 


NEW COMMAND IN 

Macro Call Name: SNCIN 
Function Code: 08/06 
Equivalent Command: None 


Reset the command-in file for the issuing task to that 


specified by the supplied pathname, or to its original 
definition. | 


[label] SNCIN [location of pathname address] 
[location of argument list address] 


ARGUMENT DESCRIPTION: 
location of pathname address 


Any address form valid for a register; provides the 
address of the pathname of the new command-in file. 


location of argument list address 


Any address form valid for an address register; pro- 
vides the address ‘of the argument list containing the 
arguments for use in command line argument 
substitution. 


FUNCTION DESCRIPTION: 


This call allows a task to reset the command-in file to that 
specified by the supplied pathname. 


NOTES: 1. The address of the pathname of the new command- 
in file supplied by argument 1 is placed in $B4; 
if this argument is omitted, SR2 is set to the 
value of 1 designating that the command-in file 
is to be reset to that initially defined for the 
issuing task. 
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2, 


The address of the argument list supplied by 
argument 2 is placed in $B2 and SR2 is set to 
zero; if this argument is omitted, $B7 contains 
the address of the argument list. 


On return, S$Rl, $R6, SR7, $B2, and $B4 contain 
the following information: 


SR1 - Return status; contains the following: 
0000 — No error 


All file management get-file and open-file 
error codes may also be returned. 


SR6 - Record length of the redefined file. 
SR7 - File status/type of the redefined file. 


$B2 - Address of the argument list (if 
supplied). 


SB4 - Address of the pathname of the new 
command-in file (if supplied). 
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NEW PROCESS o 


NEW PROCESS 

Macro Call Name: S$NPROC 

Function Code: 0D/0B 

j Equivalent Command: New Process (NEW PROC) 
Terminate the current task group request and restart the 
task group request with the same parameters as the original 
invocation of the task group for this request. 
FORMAT : 
[label] SNPROC 
ARGUMENT DESCRIPTION: 
There are no arguments for this macro call. 

FUNCTION DESCRIPTION: 
This call terminates the current request for the issuing 
task group, then restarts the request uSing the same param- 
eters aS in the original request. 


Example: 


In this example, the SNPROC macro call is used to terminate 
and restart the task group request. 


AGAIN SN PROC 
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b. If only write permission is granted (FIB program 
view word allows write but not read) the header 
label group is processed and the file positioned 
directly after the last data record. This in 
effect, is “append" mode, a way for the user to add 
records to the end of a file without having to read 
past all the existing data records. 


Trailer labels and an end-of-data tape mark are 
written when the file is closed. Files following 
the current file are lost. 


c. If read and write permissions are granted (FIB pro- 
gram view word allows both read and write) the 
header label group is processed and the file posi- 
tioned directly in front of the first data record. 
Any write request issued after the file is opened 
will cause all data records that were read to be 
preserved, and those records that were not read to 
be lost. This procedure can be used to preserve 
part of the file while renewing the rest. 


If no write operations are done and the file is 
closed, no trailer labels are written. Thus files 
located after the current file are preserved. 


{ If write operations are done, trailer labels and an 

a end-of-data tape mark are written when the file is 
Closed. Files that follow the current file are 
lost. 


3. For tapes opened in RENEW mode, the position of data 
within the file is determined as follows. 


a. Creation of the new file is initiated at the current 
tape position. (If the tape is positioned at begin~ 
ning of tape (BOT), the volume header label is 
bypassed.) The header label group is written as 
specified in the preceding get file macro call. 
After these actions, the tape is positioned at the 
end of the header label group. 


b. Data and/or files following the current tape posi- 
tion are destroyed when the file is opened. 


As part of the initialization process, this macro call 
verifies that sufficient Space is available for buffers and 
control structures. 


This macro call must be issued before any of the data man- 
agement or storage management macro calls can be executed. 
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The file information block can be generated by a SFIB macro 
call. Displacement tags for the FIB can be defined through 
the STFIB macro call. 


NOTES: 1. If the 


first argument is coded, the address of 


the FIB is loaded into $B4; if the argument is 
omitted, $SB4 is assumed to contain the address 


of the FIB. 
2. On return, $R1l contains one of the following 

status codes: 

0000 —- No error 

Olxx - Physical I/O error 

0205 - Illegal argument 

0206 - Unknown or illegal LFN 

0208 —- LFN or file already open 

0209 - Named file or directory not found 

020C —- Named volume not found 

0214 - Bad program view of file 

0217 - Access violation 

0225 - Not enough system memory for buffers or 
structures 

0226 - Not enough user memory for buffers or 
structures 

022C - Access control list (ACL) violation 

O022E - Recovery/record lock/concurrency conflict 

0232 - Invalid tape file header or tape file 
trailer label 

0237 - Invalid record or control interval format 


0238 - 


Example: 


Invalid file description information 


This SOPFIL example opens a new file, in which records are 
to be written via the data management macro call(s) that 
Follow this macro call. 
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- Following is a sample sequence of macro calls and FIB used 
( to open FILE A for processing. 
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NOTES: 1. The return point address supplied by argument 1 
is placed in $B5; if this argument is omitted, 
SB5 is assumed to contain the correct return 
point address. 


2. No return is made to the caller; control is 
returned to the address supplied in SB5. All 
registers except $R1l are preserved as they 
existed when the function was executed. In MOD 
600, register SR1 will contain the value 0006 
which is the subfunction code of the macro call. 


Example: 


In this example, the calling overlay uses the SOVRLS macro 
call to release its overlay area and return to the caller at 
the return point named OV2 RA. The calling overlay is 
assumed to be the overlay (OVLY2) that was loaded and 
executed as shown in the example for the overlay area 
reserve and execute overlay macro call. 


XLOC OV2_RA 
SOVRLS !<OV2_RA 
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OVERLAY AREA RESERVE, ae 
AND EXECUTE OVERLAY : 


OVERLAY AREA RESERVE, AND EXECUTE OVERLAY 
Macro Call Name: SOVRSV 

Function Code: 07/05 

Equivalent Command: None 


Reserve an overlay area within the specified overlay area 
table (OAT), increment the user count for that overlay area, 
load the specified floatable overlay, and transfer control 
to the overlay at the specified (or default) entry point. 
(The overlay area must have been defined through a create 
overlay area table macro call.) 


FORMAT: 


[label] SOVRSV_ [location of overlay id], 
[location of entry point offset], 
[location of OAT address] 


ARGUMENT DESCRIPTION: 
location of overlay id 


Any address form valid for an address register; pro- 
vides the overlay id of the overlay to be loaded and 


executed. (The overlay id is a binary value generated 
by the Linker.) 


location of entry point offset 


Any address form valid for an address register; pro- 
vides the offset (from the overlay load base) of the 
overlay entry point to which control is to be 
transferred. If this argument is omitted, control is 
transferred to the start address declared to the 
language processor or the Linker. 
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1601 - Invalid overlay id 

160A - Insufficient memory 

1611 - Zero length overlay 

1612 - Overlay not a user segment 
1614 - Access violation: 


o Root of sharable bound unit 
o No access 


SR2 - Overlay id (on a successful return) 


SR6 - Overlay default start address offset (on a 
successful return) 


SB4 - Overlay base address (MOD 400 only) 
Overlay load address (MOD 600 only) 
Example: 


In this example, the SOVLD macro call causes the overlay 
named DPOSIT (of the bound unit being executed) to be loaded. 
but not executed. Upon return from the system, in MOD 400 
only, $B4 will contain the overlay base address or a null 
pointer value for floatable overlays. For nonfloatable 
overlays, $B4 is not applicable. $R6 will contain the off- 
set from its base address to its default start address. The 
overlay base address and the offset to the default start 
address will be saved in OVLY_A and OVLY_E, respectively. 
Thus, the overlay can be entered later at its default start 
address by an instruction sequence such as that shown in the 
middle of the example. When the overlay is no longer 


es nage it is unloaded by the SOVUN (overlay unload) macro 
call. 
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XVAL 
SOVLD 


BNEZ 


STB 
STR 


LDB 
LDR 
JMP 


SOVUN 


LOAD THE DPOSIT OVERLAY 


DPOSIT 
=DPOSIT 


SR1, BAD LD © CHECK FOR LOAD ERRORS 


SAVE THE BASE ADDRESS AND ENTRY POINT OFFSET 


SB4, OVLY A 
SR6, OVLY E 


JUMP TO DPOSIT'S DEFAULT ENTRY POINT 


SB4, OVLY A 
SR1, OVLY E 
SB4.SR1 


THE OVERLAY 


=DPOSIT, !OVLY A 
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OVERLAY , UNLOAD 

Macro Call Name: SOVUN 
Function Code: 07/0C 
Equivalent Command: None 


Unload the specified overlay of the bound unit that contains 
the procedure being executed by the issuing task. 


FORMAT: 


[label] SOVUN [location of overlay id], 
[location of overlay base address] (MOD 400 only), 
[location of return point address] 


{ ARGUMENT DESCRIPTION: 
location of overlay id 


Any address form valid for an data register; provides 
the overlay id of the overlay to be unloaded. (The 
overlay id is a binary value generated by the Linker.) 


location of overlay base address (MOD 400 only) 


Any address form valid for an address register; pro- 
vides the base address of the overlay to be unloaded. 


location of return point address 


Any address form valid for an address register; pro- 
vides the address of the return point to which control 
will be returned after the macro call is executed. If 
this argument is omitted, the address of the first 
word following the generated monitor call sequence is 
assumed to be the return point address. 


FUNCTION DESCRIPTION: 


This call causes the named overlay to be unloaded. The 
overlay must not share a segment with any other overlay of 
the bound unit. You must have the proper access rights to 
the overlay. 7/7 
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4a. 


4b. 


The overlay id supplied by argument 1 is placed 


in $R2; if this argument is omitted, SR2 is er 
assumed to contain the overlay id. a. 
In MOD 400, the overlay base address supplied by 
argument 2 is placed in $B4; if this argument is 
omitted, $B4 is assumed to contain the base 
address. 


The return point address supplied by argument 3. 
is placed in $B5; if this argument is omitted, 
the return point address is assumed to be the 
address of the first word following the 
generated monitor call sequence. 


In MOD 400, the overlay being updated must be 
floatable, and the memory it occupies must have 
been obtained by a get memory call, either 
directly by the user or indirectly by either the 
overlay load or overlay execute macro call. If 
that memory was obtained directly by the user, 
then the address of the first word of the memory 


block must have been specified as the base 


address of the overlay when it was loaded. 


In MOD 600, the overlay being unloaded must not 

share a segment with any other overlay of the 

bound unit. The overlay must start at location | | 

0 of the segment and must occupy some part of bee 
the last 256 words of the segment. A check is 

made for flagrant misuses, however, not all pos- 

Sible errors are detected. 


On return, SR1 contains one of the following 
status codes: 


0000 


No error 


0602 Insufficient system memory 


0603 


Illegal block memory address 


0616 Overlay not in a segment (refer to 


Note 4b) 


0817 


Memory access violation 


o System segment 
o No access rights 
o Root of sharable bound unit 
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When the SRDSW macro call is executed, $R2 contains the cur- 
rent value of the external switch word. Bit 11 (bit-test 
indicator) of the I-register provides an indication of the 
setting of the switches, as follows: 


o If bit 11 is 0, none of the switches read was on. 
o If bit 11 is 1, at least one of the switches read was on. 


NOTES: 1. The bits corresponding to the external switches 
in the arguments are set on in SR2; if no argu- 
ments are supplied, $R2 is assumed to contain 
the mask to be used. If ALL is specified for 
any argument, all bits are set on in $R2. 


2. On return, S$R2 and the I-register contain the 
following information: 


SR2 - Current value of external switch word 
I-register (Bit 11) - Inclusive OR of switches 
read: 
0 —- No switch read was on 


1 - At least one switch read was on 


Example: 


In this example, the SRDSW macro call is used to read the 
Specified switches in the external switch word of the task 
group in which the issuing task is executing. The contents 
of SR2 (the mask word) are to be 2F4A so that switches 2, 4, 
5, 6, 7, 9, C, and E will be read, inclusive ORed, and 
stored in the central processor's bit indicator. To 
illustrate: 


Word: 2 F 4 A 


Bits: 0123 4567 89AB CDEF 
0010 1111 0100 1010 


Switches: 2 4567 9 CE 


The BBT instruction is used to transfer control to the rou- 
tine DO IT if one or more of the switches is turned on. 


RDSW_A SRDSW 2545, 6,.7,92C,E 
BBT DO IT 


5-359 CB08 


READ RECORD 


READ RECORD 
Macro Call Name: 


E Function Code: 


SRDREC 


11/10 (next), 11/11 (key), 11/19 (duplicate), 
11/12 (position equal), 11/13 (position greater 
than), 11/14 (position greater than or equal), 
11/15 (position forward), 11/16 (position 
backward) 


Equivalent Command: None 


Retrieves one logical record from a file to your record area 
or merely positions the read pointer to a desired record. 


Whether to 


retrieve or position is specified by the second 


(i.e., mode) argument. 


FORMAT: 


,NEXT 
, KEY 
, DUP 
, POSEQ 


[label] SRDREC £[fib address] | ), POSGR 


, POSGREQ 
, POSFWD 
, POSBWD 


ARGUMENT DESCRIPTION: 


fib address 


Any address form valid for an address register; pro- 
vides the location of the file information block 
(FIB). 
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NEXT 
NXT 


KEY 


(For all files.) This mode argument indicates that 
the record pointed to by the read pointer is to be 
read next. The read pointer is set to the next 
logical record in the file after the read is complete. 
Only active records are read (i.e., deleted records 
are skipped unless bit 11 in the program view FIB 
entry is set to 1). This is the default for this 
macro call. You must code the following FIB entries: 


logical file number 
program view (record area alignment) 
user record pointer 
input record length 


After the record is transferred to main memory, the 
system updates the following FIB entries: 


output record length 

output record address 
(Serial sequence number if device file; BSN if 
tape file; relative key for relative files and 


Simple key for other disk files). 


This mode is referred to aS read next. 


(For disk files accessed by key, only.) This mode 
argument indicates that the record identified by the 
key value pointed to by the FIB is to be read. The 
read pointer is set to the next logical record in the 
file after the read is complete. Only active records 
are read unless bit 11 in the program view FIB entry 
is set to 1. You must code the following FIB entries: 


logical file number 
program view (record and key area alignment) 
user-record pointer 


input record length 
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DUP 


POSEQ 
PEQ 


POSGR 
PGR 


input key pointer 
input key format 
input key length 


After the record is transferred to main memory, the 
system updates the following FIB entries: 


output record length 
output record address 
(Simple or relative key.) 


This mode is referred to as read with key. 


(for calc (random) files) Reads a record whose calc 
key 1S the same as the last record read. The calc key 


is pointed to by the FIB input key pointer field. 


(For disk files accessed by key, only.) This mode 
argument poSitions the read pointer to the first logi- 
cal record in the file whose key is equal to the one 
specified in the FIB. It is not necessary for the 
record pointed to to be active. The record can be 
read via a read next macro call (see above). You must 
code the following FIB entries: 


logical file number 
program view 

input key pointer 
input key format 
input key length 


This mode is referred to as read position equal. 


(For disk files accessed by key, only.) This mode 
argument positions the read and pointer to the first 
logical record in the file whose key is greater than 
the one specified in the FIB. It is not necessary for 
the record pointed to to be active. The record can be 
read via a read next macro call (see above). The same 
FIB entries as for POSEQ, above, must be coded. This 
mode is referred to as read position greater than. 
7/79 
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a 
PGE 


(For disk files accessed by key, only.) This mode 
argument positions the read pointer to the first logi- 
cal record in the file whose key is greater than or 
equal to the one specified in the FIB. It is not nec- 
essary for the record pointed to to be active. The 
record can be read via a read next macro call (see 
above). The same FIB entries as for POSEQ, above, 
must be coded. This mode is referred to as read posi- 
tion greater than or equal. 


os 
PFD 


(For tape-resident, disk sequential, and relative 
files only.) This mode argument moves the read 
pointer forward the number of record positions speci- 
fied by the key value identified in the FIB (but not 
beyond the end-of-file). It is not necessary for the 
record pointed to to be active. The record can be 
read via a read next macro call (see above). The same 
FIB entries as for POSEQ, above, must be coded. This 
mode is referred to as read poSition forward. 


ee 
PBD 


% 


(For tape-resident, disk sequential, and relative 
files only). This mode argument is the same as for 
POSFWD (above) except that the pointer is moved back- 
wards the number of record positions specified by the 
key value in the FIB (but not before the first 
record). This mode is referred to as read position 
backward. 


FUNCTION DESCRIPTION: 


Before this macro call can be executed, the LFN must have 
been opened (see the open file macro call) with a program 
view word that allows access via data management (bit 0 is 
0) and allows read operations (bit 1 is 1). The read 
pointer is a logical pointer to the next record to be read; 
it is maintained separately from the write pointer. There 
1S one read pointer per file per user. At open-file time 
the pointer is set to the first record in the file, and is 
modified by each read record operation. 


The file information block can be generated by a SFIB macro 
call. Displacement tags for the FIB can be defined by the 
SFIBDM macro call. 
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The following illustrate the effects of read actions accord- 


ing to file organizations. ~ —_ 
File Organizations Effects of Read Actions 
Sequential Read next causes sequential read. Read 
with key causes direct read. A simple 


key is used. 


Relative Read next causes a sequential read. Read 
with key causes a direct read. A 
relative or simple key can be used. 


Indexed Read next causes a sequential read. The 
records returned are in ascending sequence 
according to primary key value. (This is 
not necessarily in the same time-dependent 
or physical sequence that the records were 
loaded into the file.) Read with key 
causes a direct read. A primary key or 
Simple key can be used. 


Calc (random) Read next causes a sequential read. The 
records are returned in physical sequence. 
The file can be read directly with a calc 
key or a Simple key. 


Fixed Relative Read next causes a sequential read. Read 
with key causes a direct read. A relative 
key is used. 


Device Files Read next causes a sequential read, pro- 
vided the device can be read and was 
defined as a readable device. 


Tape Files Read next causes a Sequential read. The 
file can also be positioned n records 
forward or backward. 


NOTES: 1. If the first argument is coded, the address of 
the FIB is loaded into SB4; if the argument is 


omitted, $B4 is assumed to contain the address 
of the FIB. 


2. On return, SR1 contains one of the following 
status codes: 


'"A read, with any position mode, positions the read pointer to 


the desired record, so that a subsequent READ-NEXT will retrieve c. 

that record. | 
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aon 


| 0000 - No error 
a Olxx - Physical I/O error 
( 0203 - Illegal function 
0205 - Illegal argument 
0206 - Unknown or illegal LFN 
0207 - LFN not open 
O20A - Address out of file 
O20E - Record not found 
0217 - Access violation 
0219 - No current record pointer 
O21A - Record length error 
O21E - Key length or location error 
O21F - End of file 
O22A - Record lock overflow or not defined 
022B - Requested record is locked or causes 
deadlock 
O22F -— Unknown or illegal record type 
0233 - Tape file sequence number error 
0236 - Tape BSN or trailer label block count 
error 
0237 - Invalid record or control interval format 


Example: 


This example assumes that the address of the FIB (i.e., 
MYFIB) was loaded in $B4. In addition, the required entries 
in the FIB are those defined in "Assumptions for File System 
Examples" in Section 3. Also, it is assumed that the file 
was reserved (see "Get File"), and that the open file macro 
call was coded with the LFN and program-view entries as 
defined in the example for the open file macro call. 


The macro call is then specified as follows: 

SRDREC , NEXT 
After the record is read, the system updates the following 
entries, which you can interrogate using the FIB offset 


tags: 


F ORL (Output record length) 
F ORA (Output record address) 
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Pages 5-366 through 5-371 have been deleted 
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RELEASE SEMAPHORE 


RELEASE SEMAPHORE 

Macro Call Name: SRLSM 
Function Code: 06/03 
Eguivalent Command: None 


Release a resource controlled by the specified semaphore and 
activate the first waiting task enqueued on that semaphore 
if the value of the semaphore is negative (both actions are 
known collectively as a V-op). 


FORMAT: 


[label] SRLSM [location of Semaphore identifier] 
ARGUMENT DESCRIPTION: 
location of semaphore identifier 


Any address form valid for a data register; provides 
the two ASCII characters that identify the semaphore 
controlling the resource to be released. 


FUNCTION DESCRIPTION: 


A task issues a release semaphore macro call when it has 
finished using the resource controlled by the semaphore 
indicated in the call. The semaphore must have been pre- 
viously defined by a define semaphore macro call. 


When the release function is executed, the counter whose 
initial value was set in the define semaphore macro call is 
incremented. 


If tasks are waiting for the resource to become available, 
the first task queued on this semaphore is awakened. 


NOTES: 1. The semaphore identifier supplied by argument 1 
is placed in S$R6; if this argument is omitted, 
SR1 is assumed to contain the correct 
identifier. 
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FUNCTION DESCRIPTION: 


This macro call removes the file reservation established for 
the specified file, provided it is not currently open (see 
"Open File") in the task group in which you are executing. 
It does not dissociate the LFN from a pathname (see 
"Dissociate File"). 


Also, if the file is a temporary file (see "Create File"), 
this macro call has the same effect as the delete file 
macro call previously described. 


The file to be removed can be specified only by either an 
LFN or a pathname. When only an LFN is specified, the file 
must have been reserved previously with a get file or create 
file macro call or with an equivalent command. 


A remove file macro call does not remove a file that was 
reserved through the command GET; the command REMOVE must be 
used. 


Since the remove file macro call removes all information 
about the file from the system, subsequent get file macro 
calls may require that multiple directory levels be searched 
to again locate the file. Thus, the remove file macro call 
Should be used carefully and only after all references to 
the file are complete. 


NOTES: 1. If the argument is coded, the address of the 
parameter structure is loaded into $B4; if the 
argument is omitted, $B4 is assumed to contain 
the address of the parameter structure. 


2. On return, SR1 contains one of the following 
Status codes: 


0000 - No error 

Olxx - Physical I/O error 
0201 - Illegal pathname 

0202 - Pathname not specified 
0205 - Illegal argument 

0206 -—- Unknown or illegal LFN 


0208 - LFN or file currently open in same task 
group 


0209 - Named file or directory not found 
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Example: 


In the following example, 


technique, 


ture, results in using fewer bytes of memory while achieving 


0210 - 


020c - 


0222 - 


0225 - 


0226 - 


0229 - 


LFN conflic 


Volume not 


t 


fo und 


Pathname cannot be expanded, no working 


directory 


Not enough system memory for buffers or 


structures 


Not enough user memory for buffers or 


structures 


File not known to task group 


the macro call specifies an argu- 
ment structure built by a previous get file macro call; this 


as opposed to building a separate argument struc- 


the cancellation. 


examples: 


Example 1: 


Example 2: 


WRTFIL 


WRTFIL 


FILE A 


The macro call is coded as shown in two 


DC 5 LNF = 5 
DC 2,0 

SRMFIL !WRTFIL 

DC ~ 2°2020' NO LFN 

DC <FILE A 

RESV 2-SAF 

DC '“VOLO03>SUB>FILE AA' 
SRMFIL !WRTFIL 7 
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PATHNAME POINTER 
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sities, 


RENAME FILE/RENAME DIRECTORY 


RENAME FILE/RENAME DIRECTORY 

Macro Call Name: SRNFIL 

Function Code: 10/40 

Equivalent Command: Rename (RENAME) 


Change the name of a disk file or directory to the name 
specified by the macro call. You identify the disk file or 
directory to be renamed by supplying either a logical file 
number (LFN) or a pathname. This function is usually done 
outside program execution. 


FORMAT : 


[label] SRNFIL [argument structure address] 
ARGUMENT DESCRIPTION: 
argument structure address 


Any address form valid for an address register; pro- 
vides the location of the argument structure defined 
below. The argument structure must contain the fol- 
lowing entries in the order shown. 


logical file number 


A 2-byte logical file number (LFN) used to refer 
to the file; must be a binary number in the 
range 0 through 255, or ASCII blanks (2020), 
which indicate that an LFN is not specified. 


pathname pointer 


A 4-byte address, which may be any address form 
valid for an address register; points to a path- 
name (which must end with an ASCII space char- 
acter) that identifies the file or directory 
whose name is to be changed. Binary zeros in 
this entry indicate that a pathname is not 
specified. 
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new name 


A l- to 12-byte name, specifying the new name of 
the file or directory; must be @ simple name 
Cil.@.,% MUSE Noe ‘contain. "= “,; * “4 ™ ™)- eG.) 


FUNCTION DESCRIPTION: 


This call changes the name of the specified file or direc- 
tory. However, the volume major directory cannot be renamed 
(any attempt to do so will cause a status code of 0228 to be 
returned in S$R1). To rename the volume major directory, use 
the Create Volume command (see the Commands manual). 


The file can be renamed by specifying (1) an LFN only or (2). 


a pathname only. If only an LFN is specified, the file must 
have been reserved (through a create file or get file macro 
call, or equivalent command) with that LFN. 

NOTES: 1. If the argument is coded, the address of the 
parameter structure is loaded into $B4; if the 
argument is omitted, $B4 is assumed to contain 
the address of the parameter structure. 


2. On return, S$Rl contains one of the following 
status codes: 


0000 —- No error 

Olxx - Physical I/O error 

0201 - Illegal pathname 

0202 -—- Pathname not specified 

0205 - Illegal argument 

0206 - Unknown or illegal LFN 

0209 - Named file or directory not found 
020C - Volume not found 


0212 - Attempted creation of existing file or 
directory 


0213 - Cannot provide requested file concurrency 


0222 - Pathname cannot be expanded, no working 
directory 


0225 - Not enough system memory for buffers or 
structures 
7/79 
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Example: 


In this example, the SROGRP macro call causes a request to 
execute the commands contained in the file 
“V1124>UDD>TEST>JONES>ASM TST to be queued against the Q2 
task group. (It is assumed that task group Q2 has already 
been created with the command processor as its lead task. 
See the create group macro call for information on creating 
task groups.) The ASM TST file will also be used as the 
user-in file. The file *“V1124>UDD>TEST>JONES>L>ASM_TST.AO 
will be used as both the user-out file and the error-out 
file. The user id and the initial working directory will be 
JONES.TEST.M and “V1124>UDD>TEST>JONES, respectively. The 
argumentS -XREF and -PRINT will be passed to the command 
processor (group Q2's lead task) to specialize the control 
file ASM TST (&1 and &2, in the control file, will be 
replaced by -XREF and -PRINT, respectively). (See this sec- 
tion for a description of the SPRBLK macro used in this 
example.) 


SROGRP ='Q2',!ARGS,!INFO 


INFO SPRBLK , 1124>UDD>TEST>JONES>ASM TST; 
“V1124>UDD>TEST>JONES>L>ASM TST AO; 
“V1124>UDD >TEST>JONES =. 
ARGS SPRBLK ~XREF,-PRINT 
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REQUEST 1/0 . 


REQUEST 1/0 
Macro Call Name: SRQIO 
Function Code: 02/00 
Equivalent Command: None 
Request an I/O transfer in which the device involved in the 
transfer and the parameters defining the transfer are 
identified in the I/O request block (IORB) referred to in 
the call. 
FORMAT : 
[label] SROQIO [location of IORB address] 
ARGUMENT DESCRIPTION: i: 
location of IORB address 
Any address form valid for an address register; pro- 
vides the address of the IORB containing the device 
designation and all information about the nature of 
the I/O transfer. The IORB can be hand-coded or 
constructed through the SIORBD or SIORB macro calls. 
FUNCTION DESCRIPTION: 
This call requests an I/O transfer using a defining IORB. 
You should initially reserve the device named in the IORB. 
Device reservation can be accomplished by the get file 
(SGTFIL) macro call using device-level access (i.e., the 
pathname is in the form SPD dev_name [volid]). 
The IORB requires a logical resource number (LRN) to refer 
to the device. The LRN can be obtained by issuing a get 
file information (SGIFIL) macro call. The LRN returned by 


the SGIFIL call will be the LRN assigned to the device at 
system building time. 
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SEMAPHORE REQUEST BLOCK 


SEMAPHORE REQUEST BLOCK 
Macro Call Name: S$SRB 
Function Code: None 
Equivalent Command: None 


Generate a semaphore request block whose length is four 
words in SAF mode and five words in LAF mode. 


FORMAT : 


[label] SSRB [semaphore identifier], 
[issuing task Suspension option], 


or 


x 


[termination action] 
ARGUMENT DESCRIPTION: 
semaphore identifier 


A 2-character (ASCII) identifier that must have been 
defined by the task issuing the semaphore request. If 
this argument is omitted, the semaphore identifier is 
set to an initial value of zero. 


issuing task suSpension option 


One of the following values is specified to indicate 
whether the requesting task is to be Suspended until 
the resource associated with the semaphore becomes 
available: 


WAIT 
Suspend the issuing task until the reSource 
becomes available (set w-bit to 0) 
NWAIT 
( Do not suspend the issuing task (Set w-bit to 1) 
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If this argument is omitted, the value NWAIT is 


om 
assumed. — 
oe. be Use | bed 
If WAIT is specified, argument 3 must be omitted. 
termination action 
One of the following values is specified to indicate 
the action to be taken when the resource becomes 
available to the issuing task: | 
SM=aa 
Do not suspend the issuing task; release (V-op) 
the semaphore identified by aa (two ASCII char- 
acters) when requested task is completed. 
RB=label 
Do not suspend the issuing task; issue a request 
for the request block identified by label, when 
requested task is completed. 
If this argument is omitted (or argument 2 is WAIT), 
the generated SRB contains no termination option. 
FUNCTION DESCRIPTION: . 
The semaphore request block (SRB) is used to request 
asynchronously the reservation of a resource controlled by 
the specified semaphore. The SRB contains a Semaphore id 
which identifies the (previously defined) semaphore being 
requested. 
NOTE: This macro call cannot be used in programs written in 
SAF/LAF independent code (SLIC). See the Assembly 
Language Reference manual for more information about 
SAF/LAF independent code. 
Example: 
In this example, the SSRB macro call generates a semaphore 
request block with identifier AA. The w-bit is set to zero 
to indicate the requesting task is to be suspended until the 
resource becomes available. No suspension action is given. 
GTRAA S$SRB-~ AA,WAIT 
f~ 
\ a a 
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SEMAPHORE REQUEST BLOCK 
C OFFSETS 


SEMAPHORE REQUEST BLOCK OFFSETS 
Macro Call Name: SSRBD 


Counterpart: SSRB (see "Semaphore Request Block") 
Generated Label Prefixes: 


S _RRB/S SEM 
SRB label offset 0 

S cTl 

S CT2 

S_ ADR 


See Appendix A for the format of the semaphore request 
block. 


NOTE: This macro call cannot be used in programs written in 
SAF/LAF independent code (SLIC). See the Assembly 


Language Reference manual for more information about 
SAF/LAF independent code. 


Re 
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SET DIAL 


SET DIAL 
Macro Call Name: SSDL 
Function Code: 1B/00 
Equivalent Command: Set Autodial Telephone Number (SDL) 
Insert the specified telephone number into the first entry 
in the Auto Call Unit telephone number list for the speci- 
fied line. This telephone number will be used first when 
the Auto Call Unit facility attempts to establish a connec- 
tion on the (Switched circuit) line. 
FORMAT 1: 
[label] $SDL [location of channel number], 
[location of address of telephone number], 
CHANNEL 
FORMAT 2: 
[label] SSDL [location of address of device pathname], 


[location of address of telephone number], 
[PATHNAME | 


ARGUMENT DESCRIPTION: 

location of channel number 
Any address form valid for a data register; provides 
the four hexadecimal digits that define the 10-bit 
channel number of the data line. The channel number 


must be stored left-justified with low-order zero 
filling. (Applicable to format 1 only.) 
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location of address of telephone number 


Any address form valid for an address register; pro- 
vides the address of the telephone number to be asso- 
ciated with the data line. The telephone number must 
be stored as an aligned, nonvarying, character string 
containing at least one trailing space and no embedded 
Spaces. The telephone number can contain from 5 
through 16 ASCII characters chosen from the set 0, l, 
2, 3, 4, 5, 6, 7, 8, 9, -, *. (Applicable to formats 


st 
CHAN 


Incicates that format 1 of the macro call is being 
used (channel number of line is provided). 


location of address of device pathname 


Any address form valid for an address register. For 
example, the device pathname could be >SPD>TTY1; see 
"Get File." The pathname must be stored as an 
aligned, nonvarying, character string containing at 
least one trailing space and no embedded spaces. 
(Applicable to format 2 only.) 


octal 
PATH 


Indicates that format 2 of the macro call is being 
used (pathname of line is provided). 


FUNCTION DESCRIPTION: 


During system building, you can specify that the communica- 
tions Auto Call Unit be applied to one or more communica- 
tions lines. For each line that is to employ autodialing, 
you construct a list of telephone numbers. The first entry 
in this list is left empty by the system. The other entries 
are filled in according to your specifications. 


The SSDL macro call allows you to dynamically insert a 
telephone number into the first entry in the list for a 
particular line. When the Auto Call Unit handler is 
invoked, this telephone number will be dialed first in the 
attempt to establish a connection with the terminal(s) on 
the line. If no successful connection is established, the 
next entry (telephone number) in the list is dialed, and so 
on until a successful connection is made or every number in 
the list has been dialed. (Each telephone number is dialed 
three times at 40-second intervals.) 
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NOTES: 


Example: 


For format 1, the channel number supplied by 
argument 1 is placed in SR6; if this argument is 
omitted, S$R6 is assumed to contain the channel 
number. 


The format 2, SR6 is cleared to zero and the 
address of the device pathname supplied by argu- 
ment 1 is placed in, $B2. If argument 1 is 
omitted, $B2 is assumed to contain the address 
of the device pathname. 7 


For formats 1 and 2, the address of the tele- 
phone number supplied by argument 2 is placed in 
SB4; if this argument is omitted, $B4 is assumed 
to contain the address of the telephone number. 
For format 1, CHANNEL (or CHAN) must be coded. 
For format 2, all three arguments can be 
omitted. If this is done, S$R6 is assumed to 
contain zeros, $B2 is assumed to contain the 
address of the device pathname, and S$B4 is 
assumed to contain the address of the telephone 
number. 


On return, SR1 contains one of the following 
status codes: 


0000 —- No error 
0201 - Illegal pathname 
0701 - Channel not configured 


0702 - Auto Call Unit control unit not config- 
ured on this channel 


0703 - ACU in progress 
1704 - Illegal argument length 


170F - Invalid digit in telephone number 


In this example, the terminal whose pathname is >SPD>TTY1 is 
to be automatically dialed using the number 1-617-555-4444. 
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sie, | 


DIALAA 


PTNM 
NUM 12 


!PTNM,!NUM 12, PATH 


'>SPD>TTY1 A’ 
'16175554444A' 
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SET EXTERNAL SWITCHES 


SET EXTERNAL SWITCHES 

Macro Call Name: S$SETSW 

Function Code: 0OB/0l 

Equivalent Command: Modify ceeoenall Switches (MSW) 


Set the specified external switches in the task group's 
external switch word to on; return the inclusive logical OR 
of the previous settings. 


FORMAT: 


[label] SSETSW external Switch name, 
[external switch name], 


[external switch name] 


ARGUMENT DESCRIPTION: 
external switch name ... external switch name 


A single hexadecimal digit (0 through F) specifying 
the external switch in the task group's external 
Switch word. A maximum of 16 external switches (0 
through F) can be specified. If no arguments are Sup- 
plied, $R2 is assumed to contain a mask word specify- 
ing the switches to be set on. If ALL is Specified, 
all external switches are set on. 


FUNCTION DESCRIPTION: 


This call provides a mask by which switches can be set in 
the external switch word of the issuing task's task group. 


It also provides an indication of the previous eer of 
these switches. 
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location of Start address 


Any address form valid for an address register; pro- 
vides the location of the task start address to be 
used when the spawned task is to execute the same 
bound unit as the issuing task. (Function code 
.0C/06.) 


location of root entry name address 


Any address form valid for an address register; pro- 
vides the location of the address of the pathname of 
the bound unit root segment to be loaded for execution 
by the newly created task. The bound unit pathname 
can have an optional suffix in the form ?Pentry, where 
entry is the symbolic start address within the root 
segment. If no suffix is given, the default start 
address (established at Link time) is used. (Function 
code 0C/05.) 


FUNCTION DESCRIPTION: 


This call combines the functions of the create task, request 
task, and delete task macro calls in that it constructs the 
requisite structures for the execution of the task, acti- 
vates the task, and, when the task becomes inactive, deletes 
the task. When the spawned task is deleted, its associated 
data structures are removed and the memory they occupied is 
returned to the task group's memory pool. 


A spawned task is not assigned a logical resource number 
(LRN); therefore, the Spawned task is local to the spawning 
task (i.e., is visible only to the spawning task). A 
spawned task cannot be requested or referred to by any other 
task; nor can its memory Space or code be Shared. However, 
a spawned task can Share the memory space and code of 
another task that was assigned an LRN by a previously issued 
create task macro call. This sharing iS indicated by the 
presence of argument 3. 


Either the location of the start address or the location of 
the root entry name address, but not both, can be specified. 


Multiple task requests can be made to execute concurrently 
within a given task's bound unit; this is accomplished by 
the issuing of multiple spawn task macro calls. 


NOTES: 1. The address of the request block supplied by 
argument 1 is placed in $B4; if this argument is 
omitted, S$B4 is assumed to contain the address 
of the request block. 
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The relative priority level supplied by argument 
2 is placed in SR6; if this argument is omitted, 
SR6 is set to -l to indicate that the priority 
level of the issuing task is to be used. 
Arguments 3 and 4 are mutually exclusive; if 
both are supplied, argument 3 is used and a 
diagnostic is issued. Information derived from 
either argument is placed in $B2; if these argu- 
ments are omitted, $B2 is assumed to contain the 
Start address within the bound unit. 


On return, SR1 contains one of the following 
status codes: 


0000 - Task successfully spawned (if no wait 
condition was indicated in the request 
block) 


0000-FFFF - Posted completion status of spawned 
task (if wait condition specified) 


Olxx - Media error 

0209 - Bound unit not found 

0602 - Insufficient memory 

0801 - Request block in use (T-bit on) 

0817 -—- Memory access violation on request block 
0827 - Bound unit is not a fixed relative file 
082D - Group available memory quota exceeded 
OFO02 - No memory available for nonswappable task 
1604 - Unresolved symbolic start address 

160A - Insufficient memory 


1613 - Invalid bound unit pathname 


1614 - Access violation (root segment not user 
segment) 
1615 - Invalid bound unit file (header incorrect 


or number of overlays plus the root is 
equal to zero). 
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~e On return, SR1, SR2, S$R6, and S$R7 contain the 
following information: 


SR1 - Return status; one of the following: 


0000 - No error 
0606 - Illegal or undefined memory pool id 


SR2 - If SR1l is 0000, percentage of the memory 
pool's total memory that is currently 
available. The percentage is returned as 
an integer with the fractional value 
truncated. 


SR6, S$R7 - If $R1 is 0000, the number of words 
of memory currently available in the 
memory pool. 


Example: 


In this example, the SSTMP macro call is used to determine 
the amount of memory available in the memory pool of the 
issuing task's task group. The number of words of memory 
available in the pool is returned in SR6 and SR7. A double- 
word 2500 is subtracted from the double-word size, and the 
high-order word of the result is checked if the result is 
still positive. 


POOLCT SSTMP : | 
SUB SR7 = 2500 
BCT +SA 
ADV SR6 -1 
SA BGEZ SR6, SOMMEM 
SOMMEM SGMEM  =2500 
7/79 
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SUSPEND GROUP 


SUSPEND GROUP 
Macro Call Name: SSUSPG 
Function Code: 0OD/08 
Equivalent Command: Suspend Group (SSPG) 
Suspend the specified task group. 
FORMAT: 
[label] S$SUSPG [location of group id] 
ARGUMENT DESCRIPTION: 
location of group id 
Any address form valid for a data register; provides 
the group id of the task group to be Suspended. This 
task group must have been previously defined by a 
create group macro call. 
FUNCTION DESCRIPTION: 
In MOD 400, this call causes the system to Suspend the 
specified task group. The task group is marked as suspended 


when : 


o All tasks of the group have exited from critical areas of 
the Monitor. 


o All active task control blocks have been removed from 
their level queue. 


o All external requests (System driver, clock, memory, 
semaphore) have been satisfied. 


In MOD 600, this call suspends only the group request queue; 
a request that is active is allowed to go to completion. 


A suspended task group can be activated through the SACTVG 
macro call. 
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SUS PND 


TODAY 
HOUR 
A_DAY 


GET THE CURRENT DATE/TIME VALUE. 
SGDTM 

CONVERT IT TO AN EXTERNAL FORMAT DATE. 
SEXTDT ,! TODAY, =10 

CONVERT IT TO AN EXTERNAL FORMAT HOUR OF DAY. 
SEXTIM ,! HOUR, =2 


NOW CONVERT THE EXTERNAL FORMAT DATE/TIME 
BACK TO THE INTERNAL FORMAT. 


SINDTM !'TODAY, ,=15 


IF ITS BEFORE 0800 HOURS THE INTERNAL FORMAT 
DATE/TIME IS CORRECT ELSE ITS ONE DAY TOO SMALL. 


LDR S$R1,HOUR 
CMR $SR1,='08' 
BL >SUS PND 
AID A DAY 
CAD =SR2 


SSUS PN TIME 


TEXT "YYYY/MM/DD 0800' 

TEXT "HH! 

DC 86400000B (31,0) 
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SWAP FILE 
Macro Call Name: SSWFIL 
Function Code: 10/5A 


Equivalent Command: 


Causes a Simulated end-of-tape signal (output mode) or end- 
of-volume trailer (input mode). A continuation reel is then 
selected. If it is not online, a mount request occurs. 


FORMAT : 


[label] SSWFIL_ [fib] 
ARGUMENT DESCRIPTION: 
fib 


Any address form valid for an address register; pro- 
vides the location of the 16 word file information 
block used in data and stroage management calls. 


FUNCTION DESCRIPTION: 


This call enables the user to finish a magnetic tape file as 
though an end-of-tape signal (output mode) or an end-of- 
volume trailer (input mode) had been encountered. If a 
continuation reel is online, it is selected; otherwise a 
mount request occurs. 


NOTES: 1. The structure used for data management calls and 
storage management calls can also be used for 
the swap-file call. 


2. This function is only meaningful for labeled 
tape files; it is ignored for other files. 
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The file must be opened for either data manage- 
ment or storage management. If the file is 
opened in output mode for data management, the 
following occurs: 


o End-of-volume trailer records (EOV1/EOV2) are 
written followed by two tape marks at the 
Current tape position. 


If the tape files are opened in input mode for 
data management access, the following occurs: 


o The tape is rewound and unloaded and a normal 
reel swap is required. The reel with the 
next subsequent file section is expected. 


o Since there is no way of knowing that a file 
section is the last one in a set until the 
trailer records are read, it is the user's 
responsibility to identify the last file sec- 
tion and issue a close-file call rather than 
a swap-file call. 


o Use of the swap-file call renders the FIB 
out-record-address returned on subsequent 
read operations meaningless. This field is 
set to the current relative record number for 
tape files. 


If the tape files are opened for storage manage- 
ment access, the following occurs: 


o The tape is rewound and cycled down. 

o The user is responsible for writing any 
trailer records and tape marks for output 
files reserved for device (volume) level 
access. 


On return, S$R1 contains the following status 
codes: 


O1XX - Media error 


0205 - Illegal argument 

0206 —- Unknown or illegal logical file number 
(LEN ) 

0207 — LFN or file not open 
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SYSTEM ATTRIBUTE INFORMATION, GET 


SYSTEM ATTRIBUTE INFORMATION, GET (MOD 600 ONLY) 
Macro Call Name: SSYSAT 
Function Code: 14/11 


Equivalent Command: 


Provides the user with system attribute information about 
the software/hardware execution environment. 


FORMAT : 


[label] SSYSAT [location of marketing identifier string] 


FUNCTION DESCRIPTION: 


This call provides the user with the operating system 
identity and software/hardware attribute information. 


NOTES: 1. The address of the receiving field for the 
marketing identifier supplied by argument 1 is 
placed in $B4. S$B4 is assumed to contain the 
address of the receiving field if argument 1 
contains: =SB4. If argument 1 is omitted, SR2 
is set to zero. If any argument is present in 
argument 1, SR2 is set to -l. 


2. On return, SR1, $R2, S$R6, and SR7 contain the 
following: 


SR1 - 0 


SR2 - Provides operating system identity as 
follows: 


o 2 for MOD 200 
o 4 for MOD 400 
o 6 for MOD 600 
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Allie, 


SR6 - Provides hardware information as follows: 


o 3 for Model 3x 
o 4 for Model 4x and Model 5x 


SR7 - Indicates the presence/absence of either a 
SIP or CIP context. If SR7 (12, '13) 
contains: 


00 - No SIP context present; instructions 
not executable 


Xl - SIP simulator present 
1X - SIP hardware present 
If SR7 (13, 14) contains: 
00 — No CIP context present 
Xl - CIP simulator present 


1X - CIP hardware present 
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SYSTEM IDENTIFICATION 


SYSTEM IDENTIFICATION 

Macro Call Name: SSYSID 

Function Code: 14/04 

Equivalent Command: (MOD 600 only) USER SYSID 
Returns the identification of the system under which this 
task is running to a receiving field. The format of the 
receiving field is one word containing the number of charac- 
ters in the system id, followed by 15 words containing the 


System id itself. 


FORMAT : 
[label] SSYSID [location of system id field address] 

ARGUMENT DESCRIPTION: 

location of system id field address 
Any address form valid for an address register; pro- 
vides the address of a 30-character, aligned, varying 
receiving field into which the system will place the 
system identification... 


FUNCTION DESCRIPTION: 


This call returns the system id to a field in the issuing 
task. The system id is in the form: 


GCOS6/MOD400-rrrr-mm/dd/hh/mm 


where rrrr is the system software release number and 
mm/dd/hh/mm are the date and time that the Monitor was 
linked. 


NOTES: 1. The address of the receiving system id field 
supplied by argument 1 is placed in $B4; if this 
argument is omitted, $B4 is assumed to contain 
the address of the field. 
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SR1 - Return status; one of the following: 


0000 —- No error 
0807 - No command input defined 
0817 - Memory access violation 


SB4 - Address of the receiving task group 
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TASK INFORMATION (MOD 600 ONLY) 


Macro Call Name: STINFO 


Function Code: 14/09 
Equivalent Command: None 


Returns a Specific item of control information about the 
issuing task, depending on the argument value. 


FORMAT : 

[label] STINFO [information code] 
ARGUMENT DESCRIPTION: 
information code 


One of the following alphabetic character strings, or 


alternative numeric codes, specifying the item of 
information to be returned: 


mmnanmmmend 


Alphabetic Numeric 
String Code _ Resulting Item of Information 


CIN 0 Address of the task's command-in file 
control block (FCB) 


UIN 1 Address of the task's user-in FCB 
DIB 2 Address of task's command-in stream 
device interface module (DIM) inter- 
face block 
CLL 3 Maximum length of command input line 
LRN 4 Task's LRN 
DB 5 Task's Debug indicator 
LDT 6 Task's lead task indicator a 
PRV 7 Task's privileged task indicator ro 
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Alphabetic Numeric 


String | Code Resulting Item of Information 
STAD 8 Task's start address 
ISTA 9 Task's initial start address 


FUNCTION DESCRIPTION: 


The call returns the requested item of control information 
about the issuing task; one execution of the macro call 
returns one information item. The information, returned 


according to the information code specified in the argument, 
is placed in $B4 or SR6. 


Information resulting from strings/codes CIN/O, UIN/1, and 
DIB/2 is placed in $B4. Information from the remaining 
strings/codes is placed in SR6. For codes 5, 6, and 7 
(indicators), SR6 contains zero when these indicators are 
not set, and a nonzero value when the indicators are set. 


NOTES: 1. The string/code supplied by the argument is 
placed in S$R2. When the argument is omitted, 
the system assumes that $R2 contains the 
appropriate string/code. 


2. On return, $R1l, SR6, and $B4 contain the 
following: 


SR1 - 0000 -—- No error 
SR6 - Returned value for code 3 through 7 


SB4 - Returned address of the structure 
specified for codes 0 through 2. 


Returned with the start or initial start 
address for codes 8 and 9, respectively. 


Example: 
The issuing task requests its LRN be returned. 


GT_LRN STINFO 4 
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TASK REQUEST BLOCK 

Macro Call Name: S$TRB 
Function Code: None 
Equivalent Command: None 


Generate a task request block (TRB) whose length is 
variable. 


FORMAT : 
[label] S$TRB [logical resource number], 


v 

ant, 
NWAIT, [termination action] 
[task start address], 

[size of request block argument], 
[user argument ll], 

[user argument 2], 


v 


[user argument n] 
ARGUMENT DESCRIPTION: 
logical resource number 
A value from 0 through 252 specifying the LRN for this 


task. If this argument is omitted, the task request 
block does not have an LRN. 


WAIT |, 
NWAIT 
One of the following values is specified to indicate 


whether the requesting task is to be suspended until 
the completion of the request: 
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FUNCTION DESCRIPTION: 


The task request block is used to communicate between tasks. 
It serves as the means by which arguments are passed between 
the requested and requesting tasks within a task group. 

When a previously created task is requested, the task 
request block contains the LRN (logical resource number) 
that identifies the requested task. When a task is Spawned, 
the TRB does not require an LRN. 


The task request block may contain the start address to be 
used when the requested task is turned on to service the 
request. 


The task request block may contain a variable size portion 
that contains optional information to be passed to the 
requested task, and has a fixed size portion that contains 
Standard control information. 


When a task is activated, its $B4 register points to offset 
0 of the request block and its S$B7 register points to a 
parameter list (if one is expected by the task). The proper 
SB7 address is established by the STRB macro call when it 
has a parameter list pointer, or by placing that pointer at 
the STRBD macro call's T_PRM offset. 


Any task specific arguments are permitted (as if the TRB had 
been constructed by the command processor). 


NOTES: 1. This macro call cannot be used in programs 
written in SAF/LAF independent code (SLIC). See 


the Assembly Language Reference manual for more 
information about SAF/LAF. 


2. In MOD 600, it is the user's responsibility to 
create task request blocks in an address space 
visible to both the requesting task and the 
requested task. Task request blocks created via 
the SGETMEM macro call are visible to all tasks 
in a task group. 


Example: 


In this example, the STRB macro call is used to create a 
task request block that has a 10-word argument (in addition 
to space added) to accommodate the parameters passed to the 
task in control arguments when the task is requested. The 
generated request block will be 18 words long, have an LRN 
of 30, and, when its task terminates, will release semaphore 
AA. 


ATRBA  $TRB  30,,SM=AA,,5,XR643MX77B 
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TASK REQUEST BLOCK 
OFFSETS 


TASK REQUEST BLOCK OFFSETS 
Macro Call Name: STRBD 
Generated Label Prefixes: 


| T RRB/T_SEM 
TRB label offset 0 
T cTl 
T CT2 
T ADR 
T PRM 


See Appendix A for the format of the task request block. 
Description: 
See the task request block macro call. 
NOTE: This macro call cannot be used in programs written in 
SAF/LAF independent code (SLIC). See the Assembly 


Language Reference manual for more information about 
SAF/LAF independent code. 
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given condition is enabled (see enable user trap (SENTRP) 
macro call). When there is no established trap handler for 
the specified trap condition, the system returns a zero 
(null) pointer. 


NOTES: 1. The address for the trap handler for the 
specified trap condition is stored in the 
pointer provided by argument 1. When this argu- 
ment is omitted, or is =SB4, the system does not 
store the pointer value; that value is available 
only in SB4. 


2. The trap number of the designated trap condi- 
tion, or the value -l, designated any connected 
trap handler, derived from argument 2 (which is 
mandatory) is placed in SR2. 

3. On return, S$R1 and $B4 contain the following: 


SR1 - Return status code, one of: 


0000 - No error 
0342 - Invalid trap number 


SB4 - Address of trap handler, or zero. 
Example: 
The macro call returns a pointer to the trap handler, pre- 
viously established by the task for trap number 12. The 


pointer is returned only in SB4. 


ORYAA STRPHD ,=12 
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UNLOAD SHARABLE BOUND UNIT (MOD 600 ONLY) 

Macro Call Name: SUNSBU 

Function Code: 0O7/0E 

Equivalent Command: Unload Sharable Bound Unit (UNLOAD SH BU) 


Unload all sharable bound units that have a user count of 
Zero. 


NOTE: This macro routine iS recommended for use only by 
specialized software system deSigners. 


FORMAT : 

[label] SUNSBU 
ARGUMENT DESCRIPTION: 
None 
FUNCTION DESCRIPTION: 
This call unloads from memory all shareable bound units that 
have a user count of 0. The operating system will unload 
such bound units only if memory is needed. This call causes 
all shareable bound units, with no user, to be flushed out 
of memory. 


NOTE: On return, S$R1 contains one of: 


0000 — No error; normal sharable bound units unloaded 
083A - Use of privileged executive function attempted 
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USER IDENTIFICATION 


Macro Call Name: S$USRID 
Function Code: 14/00 
Equivalent Command: (MOD 600 only) USER ID 


Returns the user identification of the calling task group to 
a 32-character, blank filled receiving field. 


FORMAT : 


[label] SUSRID [location of user id field address] 


ARGUMENT DESCRIPTION: 
location of user id field address 


Any address form valid for an address register; pro- 
vides the address of a 32-character, aligned, non- 
varying blank filled field, into which the system will 
place the user identification associated with the 
issuing task group. 


FUNCTION DESCRIPTION: 


This call returns the task group's user id to a field in the 
issuing task. The user identification will consist of 
person.account.mode. The unused portion of the field is 
blank filled. See the Operator's Guide for further details. 


NOTES: 1. The address of the receiving user id field, 
supplied by argument 1, is placed in SB4; if 
this argument is omitted, $B4 is assumed to con- 
tain the address of the receiving field for the 
user lid. 


2. On return, S$R1 contains the following status 
code: 


OO0O00 - No error 
0817 - Memory access violation 
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Example: 


In the following example, a 16-word field is set up in the 
issuing task and the SUSRID macro call is issued to place 
the user identification of the task group in that field. 


IDO] SUSRID !USIDFL 


USIDFL  RESV 16,A'AA' 
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USER INPUT 


USER INPUT 
Macro Call Name: SUSIN 
Function Code: 08/00 


Equivalent Command: None 


Read the next record from the current input file for the 
issuing task. 


FORMAT : 


[label] SUSIN [location of record area address], 


[location of record sizel, 
[byte offset of beginning of record area] 


ARGUMENT DESCRIPTION: 
location of record area address 


Any address form valid for an address register; pro- 
vides the address of a record area in the issuing task 


into which the next record read from the current user- 
in file will be placed. 


location of record size 


Any address form valid for a data register; provides 
the size (in bytes) of the input record area whose 
address is given in argument l. 
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byte offset of beginning of record area 


Any address form valid for a data register; provides 
the byte offset of the beginning of the record area 
(from the address provided in argument 1). If argu- 
ment 3 is L, the record area begins at the left byte 
of the address specified in argument 1. If argument 3 
is R, the record area begins at the right byte of this 
address. Any other value is taken to be the location 
of the byte offset of the beginning of the record area 
from the address specified in argument 1. If argument 
3 is omitted, the record area is assumed to begin at 
the left byte of the address specified in argument l. 


FUNCTION DESCRIPTION: 


This call allows a task to read the next record from the 
Current user-in file. Unless it has been changed by a new 
user-in (SNUIN) macro call, the user-in file is that file 
identified in the request group (SRQGRP) or enter batch 
request (SRQBAT) macro call. 


NOTES: 


1. The address of the record area supplied by 
argument 1 is placed in $B4; if this argument is 
omitted, SB4 is assumed to contain the record 
area address. 


2. The record size supplied by argument 2 is placed 
in S$R6; if argument 2 is omitted, SR6 is assumed 
to contain the record size. 


3. If argument 3 is L, SR7 is set to zero to desig- 
nate that the record area begins in the left 
byte of the specified address. If argument 3 is 
R, SR7 is set to one to designate that the 
record area begins in the right byte of the 
specified address. Any other argument 3 value 
is assumed to designate the location of the byte 
offset from the address specified by argument 1 
and is placed in SR7. If argument 3 is omitted, 
the record area is assumed to begin in the left 
byte of the specified address and S$R7 is set to 
Zero. 


4, On return, $R1, $R6, SR7, and $B4 contain the 
following information: 


SR1 - Return status; one of the following: 


0000 - No error 
0817 - Memory access violation 
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All data management read-next-record 
error codes may also be returned in SRl. 


See the System Messages manual. 


SR6 - Residual range (number of bytes not filled 
in input record area) 


SR7 - File status/type (see "Command In”) 
SB4 - Address of input record area 
Example: 


In this example, the issuing task is to read the next record 
of the current user-in file into a 128-byte record area 
whose address is in RECAD. The record area begins at the 
left byte of the indicated address. 


INAA SUSIN !RECAD, =128 


RECAD RESV 64,0 
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USER MESSAGE 
(MOD 600) 


USER MESSAGE (MOD 600 ONLY) 

Macro Call Name: SUSMSG 

Function Code: 17/00 

Equivalent Command: Send Message (SEND MSG or SM) 


Send a message to another user task in another task group, 
which is identified by the group id specified in the issuing 
task's intergroup request block (IGRB). 


FORMAT : 

[label] SUSMSG [location of intergroup request block address] 
ARGUMENT DESCRIPTION: 
location of intergroup request block (IGRB) address 


Any address form valid for a data register; provides 
the address of the output IGRB that describes: (1) 
the group id of the task to which the message is to be 
sent, and (2), the location and range of the message. 


FUNCTION DESCRIPTION: 


The call allows a task to send a message to a task in 
another task group. The message must have read access, and 
its location and size specified in the IGRB. (Appendix A 
describes the intergroup request block (IGRB) .) 


The task group identified by the group id in the IGRB must 
have already been defined to the system. The IGRB must have 
write access. 


The destination task group will receive the message only 


after it has issued a user response message (SUSRSP) macro 
call. 
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WAIT LIST, GENERATE 


WAIT LIST, GENERATE 


Macro Call Name: SWLIST 
Function Code: None 
Equivalent Command: None 


Generate a wait list consisting of a count field followed by 
the specified number of request block pointers. 


FORMAT: 


[label] SWLIST [request block label 1], 
[request block label 2], 


[request block label n ] 
ARGUMENT DESCRIPTION: 
request block label 1 ... request block label n 


Label of the request block to be placed in the wait 
Last. 


If a label having a value of 0 is specified before the 
last label is supplied, an address of 0 is generated 
for the wait list entry that corresponds to that argu- 
ment position. See Appendix A for the format of the 
wait list. 


FUNCTION DESCRIPTION: 


A wait list consists of a count of the number of request 
blocks to be waited on, followed by the specified number of 
request block pointers. 


When any request block referenced in the wait list provided 


in a wait on request list macro call has been posted as 
complete, the issuing task is awakened. 
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A wait list can refer to any mixture of request blocks. 
If any pointer in the wait list is zero, it is ignored by 
the wait on request list macro call. 


The count field format is Olnn (where nn is the number of 
request block pointers specified in the macro call). 


NOTE: This macro call cannot be used in programs written in 
SAF/LAF independent code (SLIC). See the Assemb] 
Language Reference manual for more information about 
SAF/LAF independent code. 

Example: 

In this example, a SWLIST macro call is used to generate a 

list of three request block addresses (following the count 

field of 0103). 


ALSTA SWLIST TSKBO1, TSKB02, TSKBO03 
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¢ WAIT ON REQUEST LIST 


WAIT ON REQUEST LIST 
Macro Call Name: SWAITL 
Function Code: 01/01 
Equivalent Command: None 


Check the completion status of request blocks. The request 
blocks specified in the list can be a mixture of types 
(task, clock, I/O, semaphore, or overlay). 


FORMAT : 


[label] SWAITL [request block label 1], 
[request block label 2], 


[request block label nl] 
ARGUMENT DESCRIPTION: 
request block label 1 ... request block label n 


Label of the request block to be placed in the wait 
list. x 


If a label having a value of 0 is specified before the 
last label is supplied, an address of 0 is generated 
for the wait list entry that corresponds to that argu- 
ment position. See Appendix A for the format of the 
wait list. 


FUNCTION DESCRIPTION: 
This call permits a running task to indicate that it wishes 


to wait for any one of up to 255 request blocks (of any 
type) to be marked as terminated. 
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The task manager scans the wait list and checks the status 
of the specified request blocks. If it finds any request 
block marked as terminated, the task manager returns imme- 
diately to the calling task. If it finds that no request 
block in the list is marked as terminated, the task manager 
suspends the calling task until at least one of the blocks 
is marked as terminated. When the task manager is notified 
of the termination of a request block specified in the list, 
it activates the waiting task and reports the completion 
code of the terminated request. 


NOTES: 


l. 


If arguments are specified, a wait list is 
generated. The address of the wait list sup- 
plied by argument 1 is placed in $B2; if the 
arguments are omitted, SB2 is assumed to contain 
the address of the wait list. 


Upon return to the issuing task, $R1, $B2, and 
SB4 contain the following information: 


SR1 - Return status; one of the following: 


yyzz - Where yy can be O00 or 00 through EE 
for user status, or as defined for 
other yy values in the System 


Messages manual. 


OOOO-FFFF - Posted completion status of 
first completed request block 
detection. 


0802 - Invalid LRN. 


0803 - Illegal wait; (request block 
already waited on; or not pending 
for this task; or all pointers on 
this wait list were null). 


SB2 — Address of wait list 


SB4 - Address of request block that caused 
return (i.e., first completed request 
block found); if null, all pointers in the 
wait list were null. 


If arguments are present, this macro call cannot 
be used in programs written in SAF/LAF indepen- 
dent code (SLIC). See the Assembly Language 
Reference manual for more information about SAF/ 
LAF independent code. 


| 7/79 
5-512 CB08-02A 


errs 
PFD 


(For tape-resident, disk sequential, and relative 
files only.) This mode argument moves the write 
pointer forward the number of record positions 
specified by the key value identified in the FIB (but 
not beyond the end of file). The same FIB entries as 
for POSEQ above must be coded. This mode is referred 
to aS write position forward. 


nd 
PBD 


(For tape-resident, disk Sequential, and relative 
files only.) This mode argument is the same as for 
POSFWD above except that the pointer is moved backward 
the number of record poSitions specified by the key 
value in the FIB (but not before the first record). 
This mode is referred to as write poSition backward. 


FUNCTION DESCRIPTION: 


Before this macro call can be executed, the LFN must have 
been opened (see the open file macro call) with a program 
view word that allows access via data management (bit 0 is 
0) and allows write operations (bit 2 is 1). The file must 
be reserved (see the get file macro call) with write access 
concurrency control (type 3, 4, or 5). The write pointer is 
a logical pointer to where the next record is to be written; 
it is maintained separately from the read pointer. There is 
one write pointer per LFN per user. At open file time, the 
write pointer is set to the first record (if RENEW 
Specified) or logical end-of-file (if PRESERVE specified). 
The write pointer is modified by each write record 
operation. 


The file information block can be generated by a S$FIB macro 
call. Displacement tags for the FIB can be defined by the 
SFIBDM macro call. 


The following illustrates the effect of write actions 
according to file organizations. 
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File Organization 


Sequential 


Relative 


Indexed 


Effects of Write Action 


Write next: If the file is being created 
(i.e., opened in RENEW mode), the records 
Start at the beginning of the file. If the 


file is not being created, the records are 


appended to the end of the existing file. 


The position modes POSEQ, POSGR, POSGREQ, 
POSFWD, and POSBWD may be specified to do a 
"partial file renewal" or a “file shrink." 
These modes use a Simple key to address (set 
write concurrency) an active record. The 
resulting new end-of-data must lie within 
the file limits that existed before the 
write operation. 


Write-next and write-with-key produce iden- 
tical results when dealing with random 
files. A write-with-key verifies that the 
key length and key pointer references are in 
the proper position in the user record area. 
These checks are not done in the write-next 
operation. 


Write next, issued immediately after an 

open file, appends a record to the end of 

an existing file. In RENEW mode, this 
action can be used to create the file 
sequentially. Write next issued after a 
write next, write with key or with any 
position mode, inserts a record in the 

next available (unused or deleted) space. 

A write next searches for the next available 
Spaces in which to place the record. 


Write with key uses a relative or simple 
key that must address a deleted record or 
an unused space. 


All position modes use a relative or 
simple key to address (set write currency 
to) an active record, deleted record, or 
unused space. 


Write next and write with key (uSing a key 
format that indicates a primary key) pro- 
duce identical results. A write with key 
operation verifies that the key lengths 
and key format information in the FIB are 
correct and that the key pointer refers to 
the proper position in the user record ee 
area. The write next operation does not " 
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0223 - File space limit reached or file not 
expandable 


0224 - Directory space limit reached or not 
expandable 


0227 - Index limit exceeded while loading an 
indexed file 


O22A - Record lock area overflow or not defined 


022B - Requested record is locked or causes 
deadlock 
0237 - Invalid record or control interval format 


Example: 


In this example, the FIB (i.e., MYFIB) described under 
"Assumptions for File System Examples" in Section 3 is 
identified by the first argument. Assuming that the file 
has been reserved with write-access concurrency control, and 
that it has been opened as defined in the open file example, 
the macro call is specified as follows: 


SWRREC IMYFIB,NEXT 
After the record is written in the file, the system updates 
the following entry, which you can interrogate with the FIB 


offset tag: 


F ORA (output record address) 
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SECTION 6 


INPUT/OUTPUT DEVICE DRIVERS 


This section describes the internal system software, known 
as device drivers, and some related data structures, that pro- 
vide data transfer facilities for system and application programs 
with peripheral devices. Macro calls pertaining to standard 
system file input/output and to physical input/output are sum- 
marized in Section 2 and described in detail in Section 5. 


INPUT /OUTPUT DRIVERS 


Input/output peripheral drivers and the analogous communica- 
tions device drivers (called line protocol handlers) perform all 
data transfers between a peripheral device and the system or ap- 
plication program that uses it. Drivers are provided for all 
Honeywell-supplied peripheral devices and the teleprinter, VIP, 
and BSC2780/3780 protocols. 


The remainder of the section describes the peripheral device 
drivers. Line protocol handlers are described in the 


Communications Processing manual. 


Applications programs can request the drivers directly or 
can use them indirectly by calling the file manager. 


You select a driver and the priority level at which it exe- 
cutes at system building. 


The input/output drivers are reentrant programs capable of 
supporting the concurrent operation of several devices of the 
same type. The driver runs at the priority level assigned to the 
particular device at system building. The drivers provide fully 
simultaneous operation of the central processor with multiple 


input/output operations. Device interrupts signal the termina- 
tion of data transfers. 
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DEVICE DRIVER DATA STRUCTURES 


Two data structures control the interactions among an appli- 
cation program, its device drivers, and the devices the program 


uses. The structures are the input/output request block (IORB) 
and the resource control table (RCT). 


The IORB, which is partly described in this section and more 
fully in Appendix A, is the interface between the application 
task and its device driver, and iS under user control. 


The resource control table (RCT) is the interface between 
the driver and its device(s), and is not normally accessible to 
users of Honeywell-supplied drivers described in this section. 
The RCT is used by those who write their own device drivers; it 


is described in the Mod 400 and Mod 600 System Building manuals. 


DEVICE DRIVER CONVENTIONS 


The following conventions apply to all input/output device 
drivers. 


o The I/O request block (IORB) is the standard control 
structure used by a driver (see "Data Structures," later 
in this section for definition). 


o The SRQIO macro call is uséd to request a driver. 
o The B4-register contains the address of the IORB supplied 
by the caller; the IORB contains the LRN of the device to 


be used. 


o The I/O-specific words of the IORB (I CT2 through I_DVS) 
are not modified by the driver. 


o If a device becomes inoperable, it can be disabled with 
an operator command and another device can be 
substituted. 


o Drivers are reentrant and interrupt driven; one driver 
Supports many devices of the same type. 


o Synchronous and asynchronous I/O are supported. 

o The hardware status is always mapped into the software 
status word in the task's IORB (I ST) before the driver 
relinquishes control. 


Driver Functions and Function Codes 


All drivers perform similar functions on behalf of the de- 


vices and application tasks they service. These functions are a 
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carried out by the driver's request processing and interrupt 
processing code. 


The application task can request specific functions by pro- 
viding a function code in the IORB it supplies when it requests 
I/O service. These specific function codes are summarized in 
Table 6-1 and discussed under the specific function heading in 
the following pages. 


The application task uses the last four bits of the IORB 
entry I CT2 to enter the function code for the functions sum- 
marized in Table 6-1. 


Table 6-1. Input/Output Function Code 


Device 


IORB ASR/KSR 
Function Keyboard 
Printer 


Wait online 
Write 
Read 


NA 


NA 


NA 


NA 


Wait online 


Write (punch) 


Read 


Wait online 


Write 


NA 


Write file mark 


(punch) 


NA 


NA 


NA 


Break Notification NA 


Wait online 


Write 


Read 


NA 


NA 
Format write 
Format read 


NA 


Wait online 
Write 
Read 


Write file mark 


Position block” 
NA 
Position file‘ 


NA 


Connect Connect Connect Connect Connect Connect 


Disconnect Disconnect Disconnect Disconnect Disconnect Disconnect 


NA NA NA NA Read disabled device | Read disabled device 


“Not applicable. 


Positive range of one is forward space to start of next block. 
Negative range of one is backspace to beginning of previous block. 


“Positive range of one is forward space to next tape mark. 
Zero range is backspace to previous tape mark. 

Negative range of FFFF is rewind to BOT. 

Negative range of FFFF is rewind to BOT and unload. 
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WAIT ONLINE FUNCTION (fc=0) 


The "wait online" function, one element of a control mecha- 
nism used to synchronize task operation with device availability, 
allows a caller to wait until a device becomes ready for use, or 
until a specific time interval has passed. 


All noncommunications devices (except KSR-like devices) gen- 
erate interrupts when their availability changes. For example, 
when a printer runs out of paper, an interrupt is generated and 
the device is not ready for use; when the paper is installed and 
the device is again ready, another interrupt is generated. 


When a driver receives a service request from a task uSing 
the "wait online" function code in the IORB that it supplies 
(0000 in the last four bits of I _CT2), and the device is not 
ready, the driver sets a timer for 5 minutes and suspends. When 
the driver is reactivated, either by a ready interrupt from the 
device or by a time-out, it deactivates the timer, checks the 
device-ready bit in the hardware status word and places a0 or 6 
value in the return status field of the IORB depending on the 
condition of that bit. See Table 6-2 and the return status 
codes for the SRQIO (Request I/O) macro call; the rightmost hexa- 
decimal character is placed in the return status field. 


The wait online function should not be issued to a device 
that is currently ready for use unless you expect it to become 
not ready before it becomes ready again (e.g., the operator has 
been instructed to change a volume mounted on a disk device 
currently in use). 


WRITE FUNCTION (fc=1) 


The write function is available for all devices except the 
card reader. This function allows the writing of data to a 
particular device. When a driver receives a write request, it 
transfers the indicated data from a user buffer to the device 
according to the specifications supplied in the task's IORB. 


READ Peron (f£c=2 ) 


The read function is available for all devices except local 
and remote printers. This function allows reading data from a 
particular device. When a driver receives a read request, it 
transfers the data from the specified device to a user buffer 
according to the specifications supplied in the requesting 
task's IORB. 
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Table 6-2. Return Status Codes (last digit) 


Code Number 
(Hexadecimal) Meaning 


No error, operation complete 

Request block already busy (T=1) 
Invalid LRN 

Illegal wait 

Invalid parameters 

Device not ready 

Device time-out on other than connect 
Hardware error, check IORB status word 
Device disabled 

File mark encountered 

Controller unavailable 

Device unavailable 

Inconsistent request 

Device time-out on connect 


ONWPOWDYHIA UN AWNHE O 


I~ 


When these codes are found in I_CTl (IORB), or in $Rl 

on a resume after wait, look at I ST (IORB) to identify 
the specific error. The status B is returned with every 
read or write IORB that has been aborted by a disconnect 
request with queue abort. 


This status will be returned on an I/O request after an 
interrupt. The disks and tapes are disabled until the 
system's automatic volume recognition routine calls the 
enable device function. 


This status indicates illogical peripheral driver re- 
quests: read or write before connect; duplicate con- 
nect or disconnect requests; write after disconnect. 


READ DISABLED DEVICE FUNCTION (fc=E) 


This function, available only to disk or magnetic tape de- 
vices, allows the driver to bypass the device-disabled test dur- 
ing validity checking. 


This function is used by the system's automatic volume 
recognition (AVR) module, which recognizes the volume label of 
the volume on the disabled device, then enables the device so 
that attempts to read data from it can continue. 


WRITE TAPE MARK FUNCTION (fc=3) 
The write tape mark function, which is available to magnetic 


tape devices, allows you to put a mark block on a referenced mag- 
netic tape. 
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POSITION BLOCK FUNCTION (fc=4) 


The position block function, which is available to magnetic \ 
tape devices, allows you to position a referenced magnetic tape 
forward or backward one block. 


FORMAT READ (fc=5) 


The format read function, available only to disk and mag- 
netic tape devices, allows you to read all identifier and data 
fields on a track. The read begins at the first sector following 
the index mark and proceeds in the order in which the identifiers 
are recorded. 


FORMAT WRITE (fc=6) 


The format write function, available only to disk device, 
allows you to format a disk device. The disk is partitioned into 
forty two equal length sectors starting at the index mark. 


POSITION TAPE MARK FUNCTION (fc=6) 


The position tape mark function, which is available to mag- 
netic tape devices, allows you to: 


o Position a referenced magnetic tape forward to beyond the 
next tape mark. : 


o Position a referenced magnetic tape backward to ahead of 
the current tape mark. 


o Rewind to BOT. 
o Rewind to BOT and unload. 
BREAK NOTIFICATION FUNCTION (fc=9) 


This function, available for any terminal device, is a re- 
quest to notify the issuing task when a break occurS on a sSpe- 
cific device. When a break does occur, the driver posts the 
break notification request and declares the device to be in break 
mode for the issuing task. 


In break mode, all I/O requests issued from the "broken" 
task are rejected, i.e., posted without any data transfers being 
Started. Execution of a subsequent break notification request 
will cause the driver to return to normal mode. 


Communications Function Codes 


The following function codes are for communications, and for 
interactive and noninteractive (such as card reader or printer) 
devices. ‘ee 
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CONNECT FUNCTION (fc=A) 


This function provides the logical and physical connection 
between an application program and a communications device. The 
function may be used for noncommunications devices for program 
compatibility; i.e., no matter how these devices are connected to 
the computer, all interactive KSR and KSR-like devices, and 
noninteractive devices such as card reader and printer, can be 
controlled by the same application program. 


See the Communications Processing manual for descriptions of 


the connect function, and disconnect function (described below), 
as they pertain to communications devices. 


DISCONNECT FUNCTION (fc=B) 


This function code provides the logical (normal and ab- 
normal) and physical disconnect between an application program 
and an interactive device. The function is processed as a no-op 
for noninteractive devices for program compatibility, i.e., a 
card reader or printer may be controlled by the same application 
program. 


The disconnect function as a logical function indicates that 
use of the indicated device is terminated. Termination may be 
either normal or an abort of all queued read or write requests 
issued only by this user program. 


INPUT /OUTPUT REQUEST BLOCK 


The input/output request block (IORB) contains all informa- 
tion that a task requesting an I/O service can specify to define 
the operation to be performed. In addition, it contains informa- 
tion returned by the driver to the requesting task concerning the 
outcome of its I/O request. 


Figure 6-1 shows the format of a nonextended IORB. Unshaded 
fields must be initialized by the task requesting the I/O opera- 
tion. The shaded fields are set by the driver in order to return 
information about the I/O request back to the caller, or are con- 
trolled by the Monitor. 


Table 6-3 defines the specific IORB entries in a nonextended 
IORB. (See the Communications Processing manual for descriptions 
of IORB extensions.) Table 6-4 defines the software status word 
(I. ST) in the IORB. Device-specific IORB information is provided 
in the separate device driver descriptions later in this section. 


NOTE: The labels (I_CT2, I_ADR, etc.) used in referring 
to the IORB entries are employed only for ease of 
presentation. The labelS cannot be used for pro- 
gramming purposes. 
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SAF 


0 


SAF LCTI es 


1+ $AF 
2 + $AF 
2+2* SAF 
3+2* $AF 
4+2* $AF 


5 +2* $AF 
6+2*$AF 


coese: 


| CT2 FUNCTION 


| ADR BUFFER ADDRESS 


| RNG RANGE 
| DVS DEVICE SPECIFIC WORD 


|_RSR 


| ST 


oe TOTAL EXTENSION LENGTH ‘PIO EXTENSION LENGTH 


Figure 6-1. Format of I/O Request Block 


Table 6-3. Contents of I/O Request Block 


| Label contents 


0 through Depending on the S- or R-bits of 

for SAF; I CTl, this word contains a task 

0 through request block pointer (R-bit 

for LAF on), or a semaphore name (S-bit 
on); set by user, used by system 
at termination of request. 


0 through Reserved for system use. Il- or 
0 through 2-word pointer to indirect re- 
quest block. 


0 through Return status. 


8 (T) This bit is set (on) while the 
request using this block is ex- 
ecuting; it is reset when the 
request terminates. System con- 
trols this bit; user should not 
change it. In MOD 600, can be 
tested only with STEST macro 
call. 
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Table 6-3 (cont). Contents of I/O Request Block 


Contents 


Wait bit - set by user if the 
requesting task is not to be 

Suspended pending completion 

of the request that uses this 
IORB. If W=0, then the D, R, 
and S bits may not be set. 


User bit. User may or may not 
use this bit; system does not 
change it. 


Release semaphore indicator. 


0 = No semaphore in I_ SEM, 1 = 
Release, on completion, sema- 
phore item named in I_ SEM. 


Must be zero. 


Return IORB indicator. O = No 
request pointer in I RRB. 1 = 
Dispatch task request block 

named in I_RRB after request | 
timeout. If 1, system executes 
SROTSK, using I RRB, when the 

task terminates. 


Delete IORB indicator, used 
usually with the B(S) and D(R) 
bits. 0O = No delete. 1 = De- 
lete and when task terminates, 
return memory to pool where IORB 
is first entry of its memory 
block. 


Implicit task start address. 
Must always be 1 for IORB. 


1+SAF I CT2 through 7 Logical resource number (LRN); 


identifies device to be used. 


(IBM) IBM-type request. Changes in- 
terpretation of I DVS to task 
word, and I_RSR and I_ST to con- 
figuration words A and B 


respectively. 
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Table 6-3 (cont). 


C through F. 


0 through 15 


0 through 31 


Contents of I/O Request Block 


Buffer address, 


Contents : ee 4 


Byte index; 0 = buffer begins in 


leftmost byte of word, l=buffer 
begins in rightmost byte. 


Reserved for system use. 


Extended IORB indicator. 

0 = Standard (nonextended) 
TORB. 1 = IORB extended to 
at least 6+2*SAF items. Set 
by user. (See I_EXT below.) 
Function code. Driver function; 
See Table 6-l. 
Buffer address, SAF mode. 
(See note.) 


LAF mode. 
1- or 2-word pointer. 
(See note.) 


2+2* SAF I_RNG 0 through 15 Range - number of bytes to be 
a transferred. 


3+2+*SAF | I_ DVS 0 through 15 Device-specific information. 


4+2 *SAF 0 through 15 
5+2 *SAF I st 0 through 15 


e Sei iets 
| 642*SAF | I_EXT 0 through 7 


Residual range. Indicates the 
number of bytes not transferred. 
Filled in by the system on com- 
pletion of the order. Used by 
cartridge disk and mass storage 
unit driver as a data offset 
value on input. 


Modified device status; shows 
mapping of hardware status into 
software status format. See Ta- 
ble 6-4. Set by user as input 
field high order bits of sector 
number mass storage unit. Set 
by system after I/O completion. 


Left byte: Number of words in 
the IORB extension, not includ- 
ing this I_EXT word. 
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Table 6-3 (cont). Contents of I/O Request Block 


6+2 *SAF I_ EXT 8 through 15 Right byte: Number of words in 

(cont) (cont) physical I/O part of IORB exten- 
Sion, not including this I _EXT 
word. This count must be less 
than or equal to the total 
extension length specified in 
the left byte (0-7). 


This word is present only when 
the B (E) bit in I CT2 is l. 
(See the GCOS 6 Communications 
Processing manual for descrip- 
tion of IORB extensions.) 


For break notification requests, the KSR driver 
gets the identification of the issuing task in 
this field. When break occurs, the contents of 
this field are transferred to the RCT. 


7/79 
Gari CB08-02A 


ct-9 


TATFEEPE TT 


80d) 


Over/underrun 


Table 6-4. IORB Software Status Word' (I_ST) 


Cartridge Mod- 
ule Disk and 
Bit Disk Storage 
Position ASR/KSR Card Reader Card Reader/Punch Printer Diskette Cartridge Disk Unit Magnetic Tape 


RRC | cn ca a 7 SAE lap SR SER SERED |S A eA Cee ea EES PL SST a ee ES AEA EASA SSC 


Over/underrun Data service rate 
error 

Mark sense mode| Invalid ASCII End of form] Deleted field Write protect Wr ite/protect Write protect 
code error error error 


Punch echo or 


3 Even parity . 
error 


No stop bit 


40-—col umn 


read registration 


51-column mode | Light/dark check 


External clock | Card jam 
track 


Read check . 


Checksum error 


CC2 termination | ASCII code 


error 


Two Sided Missed clock Missed clock Long record 
pulse pulse 
Missed sector Successful Nonretryable 
pulse retry error 


3 termination 


Cs Co 


Fatal error Fatal error 


NOTES: 1. Nonexistent resource, bus parity, and uncorrected memory 
errors are combined into bit 15 of I ST, but each occurrence 
is noted separately in the RCT. 


The online drivers will flag, in the RCT, corrected memory 
errors and driver or hardware corrected errors. 


CALLER INTERFACE WITH DEVICE DRIVER 


To request execution of an I/O operation, the caller must 
issue a SRQIO macro call with $B4 pointing to the IORB that is 
to be serviced. If the IORB specifies synchronous I/O (W-bit 
reset), the issuing task will be suspended until the I/O opera- 
tion is completed. 


If IORB specifies asynchronous I/0, the instruction at the 
return point will be executed aS Soon as the system queues the 
IORB on the driver's level. The application may issue a SWAIT 
macro call when appropriate for the asynchronous request. 


Thus, upon return from the driver at the completion of the 
I/O operation, the caller must check the Rl register first to see 
if the request was successful. Any interface error (illegal user 
argument) will be defined here. Hardware errors are defined in 
IORB entry I ST (see Table 6-4). 


Residual range denotes how much of the requested data trans- 
fer was actually performed. If I _RSR equals zero all data was 
transferred (see "Device Drivers" for details on device-specific 
basis). For an asynchronous request, register Rl should be 
checked on return; Rl, I_ST and I_RSR should be checked after 
return from a SWAIT macro call. | 


Those fields not shaded in Figure 6-1 must be initialized by 
the task requesting the I/O operation. The remaining fields are 
set by the driver in order to return information about the I/0 
request back to the caller or are controlled by the Monitor. 
Table 6-3 describes the purpose of each field. 


Other information needed to perform the I/O request is found 
in the IORB. The caller-supplied standard function code in I_CT2 
is mapped by each driver into one or more device functions re- 
quired to perform the actual request. 


The LRN supplied by the caller in the IORB serves as a de- 
vice identifier. 


DEVICE DRIVERS 


The remainder of this section discusses the device drivers 
in the following order: 


Card reader/Card reader-punch driver 
Printer driver 

Disk driver 

ASR/KSR driver 

Magnetic tape driver 


00000 
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Card Reader/Card Reader-Punch Driver 


The card reader and card reader-punch devices are serviced 
by a single driver. The driver uses six function codes; i.e., 
read, write, write file mark (reader/punch only), connect, dis- 
connect, and wait online. In addition, its IORB word I DVS can 
be coded to define the character code of the input; namely, ASCII 
or verbatim. These values are specified in the IORB as defined 
in Table 6-6. 


The translation/mapping of these codes from punched card 
format, into memory on reading, is described below. 


In addition to the standard driver functionality discussed 
earlier, this driver also: 


o Detects and discards unsolicited interrupts. 


o Detects an end-of-file condition and sets the appropriate 
return status (ASCII GS character in column 1 of any 
card=EOF). | 


o Detects "device not ready" condition and sets appropriate 
error condition. 


ASCII MODE 


In this mode, punched cards are processed as shown in Figure 
6-2. Each card column consisting of a 12-bit ASCII card code is 
converted into an 8-bit ASCII byte and stored in the main memory. 


The ASCII card code table as specified in American National 
Standard X3.26 is given in Table 6-5. Note that no multiple 
punches in rows 1 through 7 are allowed and thus the 12-bit card 
code allows a maximum of 256 unigue codes to be defined. 


Translation is done by the card reader attachment which also 
provides a software-visible IORB status indicator that is set 
whenever an illegal ASCII card code is detected. This error con- 
dition is signaled by a 0107 in Rl register if any card column 
read had a hole pattern which was not one of the legal hole pat- 
terns given in Table 6-5. The illegal card code causes an ASCII- 
EO (all 1's) code to be loaded in the main memory. 
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Hardware 
Status 


~ 


2 
3 
4 
5 
6 
7 
8 
9 
0 


}—! 
Wm 


ASR/KSR Drivers 


Over-/underrun 

Device fault 

Read error 

Illegal seek 

Missed data synchronization 
Unsuccessful search 

Missed clock pulse 
Successful recovery 
Reserved 


Fatal error 


Table 6-18. Cartridge Module Disk Status Code Mapping 


The keyboard/printer functions of an ASR are supported; the 
paper tape reader/punch functions are not. Thus, the K-bit 
within I DVS word (Table 6-19) must be zero. 


To examine the first character of a message sent in single 
Character mode (from a local KSR terminal) before the rest of the 
message is transmitted, proceed as follows: 


1. Issue a Single character asynchronous read with no echo 


to the terminal. 


2. When the read is completed, examine the character; then 
if the rest of the message is wanted, write the charac- 
(with no carriage return or line 


ter to the terminal 
feed). 


3. Issue a read for the rest of the message (with echo). 


Note that the operator terminal (keyboard/printer), when used, 
For information about dialog with 


must be configured at LRN=0. 
the operator's terminal, see 


the Operator's Guide. 


Character codes, function codes, and device control 
for the keyboard/printer are described below. 


availabl 
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KEYBOARD INPUT 


a 
o Keyboard input is accepted until end-of-range, or car- Nei 
riage return, whichever occurs first. The carriage 
return character is not indicated as part of the input 
data. 
o Keyboard control (line feed, carriage return, etc.) is 
definable in the IORB. 
o Editing characters can control input: 
@ Deletes the previous character entered. 
CTL X Deletes all the previous characters entered on the 
same input line. 
(\) Character immediately following is treated as input. 
NOTE: Since CAN is a nonprinting character, the *DEL* 
are displayed on a separate line when CAN is 
struck. Further input may begin after completion 
of the DEL output. 
Causes character immediately following (@, CAN, CR, 
and\), to be treated as data input and not as 
editing characters; the back slash itself is not 
placed in memory. 
PRINTER OUTPUT 
o Printer output is accepted until end-of-range. 
o Time-out period for keyboard/printer operation is 5 
minutes. 
ASR/KSR DEVICE-SPECIFIC IORB FIELDS 
Table 6-19 shows the values of device-specific IORB fields 
for ASR/KSR devices. 
Table 6-19. ASR/KSR IORB Fields 
| Definition Keyboard/ | - 
IORB Item Field Printer | 7 Use 
a ase a Race ee esr ie nee Chg ee I en Ra ne ee er teag elie ney eS 
I CT2 | Function code ; l=write A=Connect Used by driver 
: | 2=reac B=Disconnect|to complete the 
3=break description of 
notifi- the requested 
cation I/O function. 
ee Pan 
. , 
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Table 6-19 (cont). ASR/KSR IORB Fields 


( | Definition Keyboard/ 
TORB Item | Field Printer 


Device- 0123 45678 9 10 1112 13 14 15 
Specific BOOS FTOQDKE LCM A 4H 

Bit Value 

B - (When function code is 9; i.e., break 


control request) 
O = Request break notification. 


1 = Abort previous break notification 
requests. 


S - 0 = Function code 2 implies normal ter- 
minal read. 


1 = Function code 2 implies single- 
character mode read. 


F - 0 = Assumes line printer format control. 


1 = Assumes terminal format control. 


T - 0 = USe control characters in control 
functions. 


1 = Treat all characters as data; bypass 
control character checks on input. 


QQ - 0 = Stop output immediately on detecting 
"attention" when the detected char- 
acter has No Stop bit status (e.g., 
a "break" key). 


1 = Post "attention" and allow completion | 
of output transfer. 


D - 0 = Read attention character with input 
(if present). 


1 = Discard attention character on input. 


K - 0 = Transfer to keyboard/printer. (Must 
be 0.) 


E - 0 = Do not echo keyboard input. 


_ 1 = Echo keyboard input. 
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Table 6-19 (cont). ASR/KSR IORB Fields 


| Definition Keyboard/ 
IORB Item] Field Printer Use 


I DVS Bit Value 
(cont) | 
L - = No line feed at end of transfer. 
1 = Issue line feed after transfer. 
C - 0 = Issue carriage return after transfer. 
1 = No carriage return after transfer. 


M - 0 = Transfer mode is 7-bit, with parity. 


1 = Transfer mode is 8-bit direct trans- 
cription mode. 
A - In Single-character mode: 


0 = Do not abort previously buffered single- 
character mode characters in queue. 


il 


Abort previously buffered single-mode 
characters in queue. 


A - On disconnect: 


0 Abort I/O requests on disconnect. 


1 Do no abort I/O requests on disconnect. 
H - 0 = Disconnect with phone hang up. 


1 


Disconnect without phone hang up. 


NOTE: The MDC-connected ASR/KSR driver 
does not check this bit. 


[ST Software Shown below Mapped by driv- 
7 status er from the 
hardware status 
in order to 


word 


tell requesting 
task the hard- 
ware status of 
the I/O opera- 
tion. 
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Table 6-21. Characteristics of Supported Tape Drives 


Speed Density 
| (ips) (bpi) 
Tape Drive | 
a (a, 800 | 556 | 200 


| 9-track 
NRZI 


9-track 

PE 

J-track X 1X 
NRZI? 


“The application program must provide for tape positioning, 
creation and interpretation of labels, tape marks, control 
information, and data contents. 


The driver provides the following callable functions: 
o Wait online 
o Write 


Oo Read (forward) 


o Position block (forward and backward) 


o Position forward or backward by tape mark, rewind to 
beginning of tape (BOT), rewind to BOT and unload. 


The driver operates in the following modes: 

o Odd parity (9-track tape only) 

o Odd parity 6-bit (7-track tape) 

o Even parity 6-bit (7-track tape) 

o Packed, always odd parity (7-track tape) 

o Minimum data block, MDB (American National Standard 
specifies 18 or more characters per block in write, 8 
or more in read) 

o MDB-inhibited (If fewer than the specified number of 


characters must be read or written, this mode is 
required.) 
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If MDB mode is specified for a write and the range is less 
than 18 characters, a parameter error is reported. If MDB mode 
is specified for a read and the range is less than 12 characters, 
the user will receive the first portion (requested range) of the 
first valid block and an unequal length check. If a "Short re- 
cord" is detected, a corrected media error is reported in status 
word, I ST. If a record of less than 18 characters is written or 
less than 12 characters is read, the inhibit block size check bit 
(bit 12 of the device specific word, I DVS) must be set. 


Beginning of tape (BOT), end of tape (EOT), and end of file 
(EOF) conditions are reported for appropriate user action. If an 
error occurs in a case when the operation can be retried, the 
driver backspaces and reissues the order up to 32 times before 
reporting a hardware error. If an error occurs and no retry is 
possible, the driver rewinds and forward spaces to the problem 
block and reissues the order once before reporting a hardware 
error. The driver does not check the tape volume identifier. 


The EOT return status is not returned for read operations; 
only the EOT status word bit is set. It is assumed that appro- 
priate application software conventions will prevent reads that 
would force the tape off the end of the reel. 


The resident magnetic tape driver is interrupt driven and 
must execute with a resident Monitor and with the central pro- 
cessor in the privileged state. It can support, on an adapter, 
one data transfer simultaneously with one or more rewind/rewind- 
unload orders. 


MAGNETIC TAPE DEVICE-SPECIFIC IORB FIELDS 
The IORB fields defined in Table 6-22 are specific to mag- 
netic tape devices. All other IORB fields are defined in pre- 


vious subsections. 


Table 6-22. Magnetic Tape IORB Fields 


Definition 


Wait onlin 

Write 

= Read 

Write filemark 

Position by block (see range) 
Format read 

Position file (see range) 
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Table 6-22 (cont). Magnetic Tape IO 


RB Fields 


O=Normal American National 


Standard bloc 


l=Inhibit sensi 


k sizes 


ng for American 


National Standard block size 


= 9-track tape; or 7-track 


in odd pari 


ty 6-bit mode 


7-track tape in even 


parity 6-bi 


t mode 


7-track tape in packed 


mode 


Write: 1 through 7FFF 
Read: O means verify 
Position by block: Ne 

sp 


Po 
Sp 


Position by file: -2 
-l 


0 


I_RSR | Residual range Nonzero when physical 
range. 


A eT 


A read with a range of zero verifies the 
with no data transfer to memory. 


; 1l through 
7FFE, is valid 


gative is back- 
ace; 0 is illegal 


Sitive is forward 
ace 


= Rewind and unload 
= Rewind to BOT 


= Backspace to pre- 
vious tapemark 


= Forward space to 
tapemark 


block exceeds 


selected sector 
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MAGNETIC TAPE HARDWARE/SOFTWARE STATUS CODE MAPPING 


The hardware/software status code mapping for magnetic tape 
devices is shown in Table 6-23. 


Table 6-23. Magnetic Tape Hardware/Software Status Code Mapping 


RCT TORB 
R_ STTS I ST Meaning If Bit Set 


Device ready 
Attention 
Rewinding 
Error —- Operation can be retried 
MBZ 
Write protected 
Corrected media error 
Tape mark 
BOT 
EOT 
Unequal record length 
Error — Operation cannot be retried 
MBZ 
11 Operation check 
= Corrected memory error 
12 High density 
15 Nonexistent resource/fatal error 
Bus parity error/fatal error 
Memory error - correction impossible/fatal error 


WOOMONANA UNH | WNhH Il rO 


tr 
OWUONDAD! Il wine il | 
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Table A-1l. Contents of Clock Request Block 


Item Label Bit(s) Contents 


-SAF C_RRB/ | 0-15 Depending on the condition or the S or R 
C_ SEM bits of C CTl, this word contains a task 


request block pointer (R-bit on), or a 
semaphore name (S-bit on). 


po C_LNK Reserved for system use. 
0-7 


SAF CCT Return status | 
This bit is set on while the request 
uSing this block is executing; it is 
reset when the request terminates. The | 
system controls this bit; user should 
not change it. In MOD 600, can be tested 
only with STEST macro call. 
Wait bit - set if the requesting task is 
not to be suspended pending the comple- 
tion of the request that uses this block. 
User bit. User may or may not use this 
| bit; the system does not change it. In 
MOD 600, user must not use this bit; in 
a user-built CRB, must be O initially. 
Release semaphore indicator. 
= No release, 1 = Release, on timeout, 
semaphore item named in C_SEM. 
Must be zero. 
Return clock RB indicator. 
NO dispatch; 1 = Dispatch task re- 7 
quest block named in C_RRB after request 
| timeout. If 1, system executes SROQTSK, 
uSing C_RRB when the task terminates. 
Delete clock RB indicator, used usually 
with the B(S) and D(R) bits. 
O = No delete. 1 = Delete and when 
task terminates, return memory to pool 
where CRB is first entry of its mem- 
| ory block. 
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Table pee CONE es Contents of Clock Request Block 


eae CCT « a rplicit task start address. Must al- 
(cont) a ways be 1 for CRB. 


1+SAF |C cT2 Value is -l. 

8 (C) When set, indicates this block is asso- 
ciated with a cyclic clock function. 
When set, last two words contain an in- 
terval in units specified by M. Each 
interval value is as follows: 001 - in 
milliseconds; 010 - in tenths of a sec- 
ond; 011 - in seconds; 100 - in minutes; 
101 - in units of clock resolution. 
When reset (off), the last three words 
contain a date/time interval. 


2+SAF Contents depend on M bit of C CT2. 


FILE INFORMATION BLOCK Lee FORMAT AND CONTENTS 


Figures A-3 and A-4 show the format, and Tables A-2 and A-3 
show the contents, of the file information block (FIB) for data 
management (record level) access, and for storage management 
(block level) access, respectively. 


Label (s) (OB GOO on MOOS ee 
F LEN Logical File Number (LFN) 
User Record Area Pointer 


Word 


Ree ee ee 


Figure A-3. Format of FIB for Data Management 
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Table A-2 (cont). Contents of FIB for Data Management 


1 for primary key 


F IKE O- 0-7 
2 for simple key 


12,13] F_ORA on rs record address. 
14,15) F_ RFU2 Reserved for later use, must be 00000000. 


Table A-3. Contents of FIB for Storage Management 


F LFN | 0-15 Logical file number (LFN). 


1 F PROV Access level; set on for storage management. 


Input key format: 0 for none aie ten oe: een one cee ee.:~*«*«*«*s 


HE) (EEE) 


Process rules: bit 1 for S$RDBLK, bit 2 
for SWRBLK. 


Must be OOO00000. 


Buffer alignment: set on when buffer begins 
on odd-byte boundary; off when even-byte 


boundary. 

Transcription mode: set on when data 
transferred in binary transcription mode; 
off when transfer is in ASCII mode. 
SynchronouS/asynchronous indicator: set on 


when S$RDBLK and SWRBLK calls executed asyn- 
chronously; off when synchronously. 


F UBP 0-31 Start address of user buffer area. | 
F BFSZ 0-15 | Be Buffer transfer size. | 
2 Co 


F BKNO Block number. 
F RFU3 Reserved for later use; must be all zeros. 
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 INPUT/OUTPUT REQUEST BLOCK (IORB) FORMAT 
Figure A-5 shows the format of a nonextended input/output 
request block (IORB) (See the GCOS 6 Communications Processin 
manual for descriptions of IORB extensions.) Table A-4 defines 
the specific fields in a nonextended IORB. Table A-5 summarizes 
the IORB fields for operator interface functions. 


3 4 5 6 7 8 9 A B 


>) 
_ 
N 
©) 
O 
m 
nn 


—$AF 
{ bi) RRB/I_SEM REQUEST BLOCK POINTER/SEMAPHORE NAME 


O- i_-LNK RESERVED FOR SYSTEM USE AS A POINTER 


ot foe et a | 


$AF | CT1 RETURN STATUS 


Bl 
=e 
mle 


6+2*$AF I-EXT PIO EXTENSION LENGTH 


Figure A-5. Format of I/O Request Block 


Table A-4. Contents of I/O Request Block 


Item Bit(s) Contents 


Depending on the S or R bits of 
I CTl, this word contains a task 
request block pointer (R-bit on), 
or a semaphore name (S-bit on). 
Set by user; used by system at 
termination of request. 


Reserved for system use. 1- or 
2-word pointer to indirect re- 
quest block. 


Return status 


This bit is set (on) while the request 
using this block is executing; it is 
reset when the request terminates. 
| The system controls this bit; user 
should not change it. In MOD 600, can 
be tested only with STEST macro call. 
7/79 
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Table A-4 (cont). Contents of I/O Request Block 


( Item Label Bit(s) Contents 
PEER TORII GIRL AORN EE aR A RIG (DREN eps FW tre PCR NEUSE ye Pie ir eI sca pI Dee CO PUN EN NN Se DE a ORR TG ME 
SAF i CT). Wait bit - set by user if the request- 
(cont) (cont) ing task is not to be suspended pend- 
ing completion of the request that 
uses this IORB. 


User bit. User may or may not use 
this bit; the system does not change 
it. 


Release semaphore indicator. 


O = No release, 1 = Release, on com- 
pletion, semaphore item named in 
I_ SEM. 


Must be zero. 
Return IORB indicator. 


O = No dispatch. 1 = Dispatch task 
request block named in I RRB after re- 
quest timeout. If 1, system executes 
SROTSK, using I_RRB, when the task 
terminates. 


Delete IORB indicator, used usually 
with the B(S) and D(R) bits. 


O = No delete. 1 = Delete and when 
task terminates, return memory to 
pool where IORB is first entry of 
its memory block. : 


Implicit task start address. Must 
always be 1 for IORB. 


1+SAF Logical resource number (LRN); identi- 


fies device to be used. 


I cr2 | 0-7 


8 (IBM) IBM—-type request. Changes interpre- 
tation of I_ DVS to task word, and of 
I RSR and I_ST to configuration words 
A and B respectively. 

9 (B) Byte index: O=buffer begins in left- 


most byte of word, l=buffer begins 
in rightmost byte. 
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Table A-4 (cont). Contents of I/O Request Block 


l+sar I Procr2 
(cont) (cont) 
B(E) 


- 
_ xin 


3+2*SAF | I_DVS 


44+2*Sar | 1_RSR a 


Private space; reserved for system 
use. | 


Extended IORB indicator. 


0 = Standard (nonextended) IORB. 
1 = IORB extended to at least 6+2*SAF 
items. Set by user. (See I_EXT 
below.) 


Function code. Driver or LPH func- 
tion, see Table 6-l. 


Buffer address, SAF 
Buffer address, LAF 1- or 2-word 
pointer. 


Range -— number of bytes to be trans- 
ferred. Used as input field for 
cartridge disk or mass storage unit. 


Device-specific information. 


Residual range. Indicates the number | 
of bytes not transferred. Filled in 
by the system on completion of the 
order. Used by the cartridge disk and 
mass storage unit drivers as a data 
offset value. 
5+2*SAF | I ST Modified device status; shows mapping 
of hardware status into software 
status format. See Table 6-4. Set 

by user aS input field high-order bits 
of sector number of mass storage unit. 
Set by system after I/O completion. 


6+2* SAF Left byte: Number of words, in 
binary, in the IORB extension, not in- 


cluding this I_EXT word. 


Right byte: Number of words, in 
binary, in physical I/O part of IORB 
extension, not including this I_EXT 
word. This count must be less than 
or equal to the toal extension length 
specified in the left byte (0-7). 
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Table A-4 (cont). Contents of I/O Request Block 


6+2*SAF erm EXT  g-15. 15 
(cont) (cont) 


(cont) 
Table A-5. Summary of IORB Fields for Operator Interface 


I Pr ocrl o(w) For a F pow a SopMeG @ail, cue Seeking. of ene. call, the setting of the 
W-bit in the output IORB controls re- 
turn to the caller. For a SOPRSP 
call, the setting of the W-bit in the 
input IORB controls return to the 
caller; the setting of the W-bit in 
the output IORB has no significance. 
For either call, return to the caller 
is immediate if the significant W-bit. 
is on. If the significant W-bit is 
off, return to the caller occurs after 
i | the order is completed. 
- 1+SAF t {Cr LRN=0 
9 (B) Must be off if the input/output buffer 
| | begins at the left byte of the word 
whose address is contained in word 3 
(I ADR) of this IORB. Must be on if 
| the input/output buffer begins at the 
right byte. 
(Which contains an output message or 


2+SAF I_ADR 0-15 
is to receive an input message). 
2+2*SAF | I_RNG 0-15 The buffer size in bytes. This is the 
length of an output message or the 
maximum length allowed for an input 
message. 


SEMAPHORE REQUEST BLOCK FORMAT 


This ante Word §s presente Gale wnen tne! is onerierd Sale when the 
B(E) bit in I_CT2 is l. (See the 
GCOS 6 Communications Processing 
manual for description of IORB 
extensions.) 


The word address of the message buffer 


Figure A-6 shows the format of the semaphore request block; 
Table A-6 shows it contents. 
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—$AF). : : , 
ts RRB/S_SEM REQUEST BLOCK POINTER/SEMAPHORE NAME 


TLNK | RESERVED FOR SYSTEM USE 
$AFS CT1 


1+$AF S CT2 


2+$AF S_ADR: | SEMAPHORE IDENTIFIER 


Figure A-6. Format of Semaphore Request Block 


Table A-6. Contents of Semaphore Request Block 


Item | Label | Bit(s) Contents 


-SAF | S_RRB | 0-15 Depending on the S or R bits of S CTI, 
this word contains a task request block 
pointer (R-bit on), or a semaphore name 
(S-bit on). Set by user; used by system 
when request terminates. 


-1 | S_SEM 


Return status 


This bit is set (on) while the request 
using the block is executing; it is reset 
when the request terminates. The system 
controls this bit; user should not change 
it. In MOD 600, can be tested only with 
STEST macro call. 


Wait bit - set if the requesting task is 
not to be suspended pending the comple- 
tion of the request that uses this block. 


User bit. User may or may not use this 
bit; the system does not change it. 


Release semaphore indicator. 


No release, 1 = Release, on completion, 
semaphore item named in S_SEM. es 
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; Table A-6 (cont). Contents of Semaphore Request Block 

( Item | Label ; Bit(s) Contents 

| AI an a eee cea aN ae a re rr ee nae ee ng ce rw le nee Re 
c Must be zero. 


Return semaphore RB indicator. 


no dispatch. 1 = Dispatch task request 
block named in S RRB after request time- 
out. If 1, system executes SROTSK, 
using S RRB when the task terminates. 


Delete SRB indicator, used usually with 
the B(S) amd D(R) bits. 


O = No delete. 1 = Delete and when task 
terminates, return memory to pool where 


SRB is first entry of its memory block. 


Implicit task start address. Must always 
be 1 for SRB. 


Value is -l. 

( Must be eons 
Must be one. 
Semaphore identifier - two ASCII 
characters. 

TASK REQUEST BLOCK FORMAT 


Figure A-7 shows the format of the task request block; 
Table A-7 shows its contents. 


—$AF) : 
1 tr_RRB/T_ SEM REQUEST BLOCK POINTER/SEMAPHORE NAME 


O T_LNK | RESERVED FOR SYSTEM USE AS A POINTER | 
ren cumemns [eo] =[o[afo] 
ee ebetelepetetele 


2+$AF T ADR START ADDRESS IF I=0 


2+2*$AF T PRM BEGINNING OF ARGUMENT LIST 


Figure A-7. Format of Task Request Block 
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Table A-7. Contents of Task Request Block 


Item Label Bit(s) Contents 


-SAF T RRB/ 0-15 Depending on the condition of the S or 
-1 T SEM R bits of T_CTl, this word contains a 
task request block pointer (R-bit on), 
or a semaphore name (S-bit on). Set by 
user, used by system when request 
terminates. 


po T LNK Reserved for system use. 
0-7 


SAF Return status. 


This bit is set (on) while the request 
using this block is executing; it is 
reset when the request terminates. The 
system controls this bit; the user 
Should not change it. In MOD 600, can 
be tested only with STEST macro call. 


Wait bit - set by user if the requesting 
task is not to be suspended pending the 
completion of the request that uses this 
block. 


User bit. User may or may not use this 
bit; the system does not change it. 


Release semaphore indicator. 


O = No release, 1 = Release, on comple- 
tion, semaphore item named in T_SEM. 


Must be zero. 
Return task RB indicator. 
0 = No dispath. 1 = Dispatch task re- 
quest block named in T_RRB after request 
timeout. If 1, system executes SROQTSK, 


uSing T RRB when the task terminates. 


Delete TRB indicator; used usually with 
the B(S) and D(R) bits. 


0 = No delete. 1 = Delete and when task 
terminates, return memory to pool where 
TRB is first entry of its memory block. 
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Table A-8 (cont). Message Group Control Request Block (MGCRB) 


| 


Major status. | 


Left byte: reserved for system 
use. 


This bit is set (on) while the re- 
quest uSing this block is execut- 
ing; it fs reset when the request 
terminates. The system controls 
this bit; user should not change 
it. In MOD 600, can be tested only 
with STEST macro call. 


Wait bit - set if the requesting 
task is not to be suspended pending 
the completion of the request that 
uses this block. 


User bit. User may or may not use 
this bit; the system does not 
change it. 


Release semaphore indicator. 
Values: O=No release, 1=Release, 
on closeout, of semaphore which 
must be in MC_OS -l. 


Must be zero. 


Return request block indicator. 
Values: O=No dispatch, 1=Dispatch 
of request block whose address must 
be contained in MC_OS -SAF, after 
closeout of this request. System 
executes SROTSK using the address 
of the request block contained in 
MC_OS -SAF upon request 
termination. 


Delete request block. Values: 
O=No delete, 1=Delete, and return 
memory to the pool where MGCRB 

is the first entry of its memory 
block. 


I/O bit. Must be set. 


; 
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Table A-8 (cont). Message Group Control Request Block (MGCRB) 


1+SAF MC OPT 


2+SAF MC _BIF| Address 
O-15 (SAF) 
10-31 (LAF) 


2+2* SAF MC BSZ|0-F Buffer range. 
3+2*SAF Record-type code. 


MC REC] O-F On send, insert record-type code. 
On receive, return assigned 
| record-type code. 


General options: 
Reserved for system use. 
Must 
Byte index: 0 = Buffer begins in 

leftmost byte of 


the word. 


Buffer begins in 
rightmost byte. 


QO. 


Must 1 (extended MGCRB). 


0. 


Pointer 


Buffer pointer. 


Buffer pointer. 


4+2*SAF mc_RSR]O-F Residual range. 


5+2*SAF MC_MRU| 0-7 Left byte: end message recovery 
unit (MRU). Reserved for system 
use. 


MC _WTI| 8-F Right byte: wait test indicator. 
00 Return null value 
to application. 
O1 = Wait 
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Table A-8 (cont). Message Group Control Request Block (MGCRB) 


6+2*SAF | MC_EXT Extension mechanism. 
0-7 Left byte: binary value of 
13+2*SAF, i.e., number of words in 
MGCRB following the extension word. 
Right byte: must be hexadecimal 7. 


7+2*SAF Next seven words. Reserved for system physical I/O use. 


14+2*SAF] MC _FNC}0-7 Left byte: function. Reserved for 
system use. | 
MC REV]|8-F Right byte: revision. Must be 
hexadecimal 1. 


15+2*SAF}] MC MGI Message group i.d. 
O-F Returned in the SMINIT and SMACPT 
macro calls. 


. 16+2*SAF] MC_LVL Enclosure level. 
{ 0=/] Left byte: enclosure level 
requested. 

8-F | Right byte: enclosure level de- 
tected according to following ASCII 
values: 

Not end of record 

End of record 

End of quarantine unit 
End of message. 


17+2*SAF| MC_PCI Must be 0. 


MC_VDP |Address Name-list pointer. 


18+2*SAF | 


O-15 (SAF) Must be 0O. 


0-31 (LAF) Must be 0. 


18+3*SAF| MC_TGI Reserved for system use. 
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Table A-8 (cont). Message Group Control Request Block (MGCRB) oo 


pee Bit(s) _ Contents My 


19+3*SAF | MC_TSK/Address Pointer. 


0-15 (SAF) Reserved for system use. 
0-31 (LAF) | Reserved for system use. 


19+4*SAF | MC_NPI|0-F Must be 0. 


Table A-9. Message Group Initialization Request Block (MGIRB) 


Label Bit(s) Contents 


a ahaa te ee tae ea sn take En ek eas Ie ls ce hehe wee ne Ree eg ee ee ee a 
Address Pointer: reserved for system uSe. 


0-15 (SAF) 
0-31 (LAF) 


= = 
an i 
| fe 
5 | oO 
>) 

Cy 


Major status. 


Left byte: reserved for system 
use. 


This bit is set (on) while the 
request using this block is ex- ame 
ecuting; it is reset when the re- | 

quest terminates. The system 

controls this bit; user should not 

change it. In MOD 600, can be 

tested only with STEST macro call. 


Wait bit - set if the requesting 
task is not be suspended pending 
the completion of the request 
that uses this block. | 


User bit. User may or may not use 
this bit; the system does not 
change it. 


Release semaphore indicator. 
Values: O=No release, 1=Release, 
on closeout, of semaphore which 
must be in MC_OS -l. 


Must be zero. 
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Table A-9 (cont). Message Group Initialization 
é Request Block (MGIRB) 


SAF MI_MAJ| D(R) 
(cont) (cont) 
E (D) 


1+SAF MI OPT 


Return request block indicator. 
Values: O=No dispatch, 1=Dispatch 
of request block whose address must 
be contained in MC_OS -SAF, after 
closeout of this request. System 
executes SROTSK using the address 
of the request block contained in 
MC OS -SAF upon request 
te¥mination. 


Delete I/O request block. Values: 
O=No delete, 1=Delete, and return 
memory to the pool where MGIRB is 


the first entry of its memory 
block. 


ry 


I/O bit. Must be set. 


General options. 


0-7 Reserved for system use. 
8—-A Must be 0. 

B Must be 1 (extended MGIRB). 
C-F Must be 0. 


2+SAF MI BUF| Address Pointer. 
O-15 (SAF) Must be 0. 
O-31 (LAF) Must be 0. 


2+2*SAF MI_ BSZ Buffer range. 

O-F Must be 0. 
3+2*SAF | MI_MPD/ O-F Message path description identi- 

fier. Must be hexadecimal 1. 

4+2* SAF MI_RSR Residual range. 

O-F Reserved for system use. 
5+2*SAF | MI_MDE| 0-7 Left byte: must be 0. 

MI IOP| 8-F Right byte: must be 0. 


6+2*SAF | MI_EXT Extension mechanism. 
0-7 Left byte: binary value of 
| 31+2*SAF, i.e., number of words in 
MGIRB following the extenSion word. 
. | 8-F Right byte: must be hexadecimal 7. 
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Table A-9 (cont). 


Message Group Initialization 


Request Block (MGIRB) 


7T+2*SAF 


14+2*SAF | MI FNC 


MI REV 


15+2*SAF | MI MGI 


16+2* SAF 


18+2*SAF | MI ADT 


Next seven words. Reserved for system physical I/O uSe. 


Function. 


Left byte: reserved for system 


uSe. 


Revision. 


Right byte: must be hexadecimal l. 


Message group i.d. 


Returned in the SMINIT and SMACPT 
Macro calls. 


Address type. 


Left byte: address type 
(initiator); must be hexadecimal 1. 


Right byte: address type 
(acceptor); must be hexadecimal l. 


0-7 
a 
| 
MI PCM 
(Two O-F 
words) | 0-F 
0-7 
8-F 
O-F 


20+2*SAF | MI_ NDI 


21+2*SAF | MI_MBI 


Must be 0. 


Initiator mailbox name. 


Must be from 1 to 12 ASCII 
characters, blank-filled, left 
justified. 
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hana 


; Table A-9 (cont). Message Group Initialization 
( Request Block (MGIRB) 


Item Bit(s) Contents 


29+2*SAF 


a 


Acceptor mailbox name. 


Must be from 1 to 12 ASCII charac- 
ters, blank-filled, left justified. 


( 36+2*SAF | MI_CNT 


37+2*SAF | MI_TGI | 


O-F 
O-F Initiator —- maximum size of quaran- 
tine unit. 
O-F Count of number of active messages 
in the mailbox. Returned with 
SMCMG macro call. 


Reserved for system use. 
38+2*SAF | MI_TSK Pointer. Reserved for system use. 
38+3*SAF | MI_SIP Reserved for system use. | 
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Table A-10 (cont). Message Group Recovery Request Block (MGRRB) 


Item Bit(s) Contents 


ee ee Da eee a ee eg oe ne ea ee ee Pe we aed, ec ee See eR eA Sal 
Major status. 


Left byte: reserved for system 
use. 


This bit is set (on) while the re- 
quest using this block is execut- 
ing; it is reset when the request 
terminates. The system controls 
this bit; user should not change 
it. In MOD 600, can be tested 
only with STEST macro call. 


Wait bit - set if the requesting 
task is not to be suspended pending 
the completion of the request that 
uses this block. 


User bit. User may or may not use 
this bit; the system does not 
change it. 


Release semaphore indicator. 
Values: O=No release, 1=Release, 
on closeout, of semaphore which 
must be in MC_OS -l. 


Must be zero. 


Return request block indicator. 
Values: O=No dispatch, 1=Dispatch 
of request block whose address must 
be contained in MC OS -SAF, after 
closeout of this request. System 
executes SRQOTSK using the address 
of the request block contained in 
MC OS -SAF upon request 
termination. 


Delete I/O request block. Values: 
O=No delete, l1=Delete, and return 
memory to the pool where MGRRB is 
the first entry of its memory 
block. 


I/O bit. Must be set. 
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G-d 


80d0 


Table B-1 (cont). Macro Calis, Function Codes, and Register Contents 


Contents Before Execution Contents Returned 


macro cai] m1 | ra fre fe? fsa se fer fro eee fee fs 
Overlay Handling Functions (cont.) 
Status | Overlay Of fset Size Base 
status address 


07/03 Overlay 
id 
07/05 Overlay Offset Status | Overlay 
id id 
Status | Oerlay Offset oe 
id 


07/06 

Actual Actual 
size of size of 
overlay entries 
area in 
overlay 
area 


SOVST 


SOVRSV Overlay 


area 
table 


address 


SOVRLS 


SOVRCL Request 
block 


address 


07/07 


SCROAT 07/0A 


Number of 
entries 
in overlay 


07/0C Overlay B5 = Return point Base Status 
id address address 
~ 7 SaaS ey PP ppp 
wav fom | || | | lem? | | | [| | | — 
08/00 Record Address Status 
size record 
area 
SUSOUT 08/01 Record Offset Address {|Status 
size record 
SCIN 08/02 Record Offset Address Range File 
size record Type 
area 
SEROUT 08/03 Record Offset Range 
size 


Size of 
overlay 
area entry 


: 


SUSIN 


Address 
record 
area 


Address 
record 
area 


Address Status 
record 


Contents Before Execution Contents Returned 


mero can] a [as i eee Yn ne ns er ee oe ss 
Standard System File I/O Functions (cont.) 


SNUIN 08/04 0,1, Address {j Status Record os Address 
or 2 pathname length pathname 


| 08/05 0 or 1 Address || Status Record te Address 
| pathname length pathname 
SNC IN 08/06 Oor 1 Address | Address || Status Record File Address dein taieha 
argument; pathname length Type argument] pathnam 
list list 


| Operator Interface Functions 
SOPMSG 09/00 Address || Status a 
TORB a 


SOPRSP © 09/01 Address Status Address 
| IORB ee 
| eo 

09/02 -__|—+— 


9- 
aoe 
3 |% 


Trap Handling Functions . 


Address Status 
handler 


Status | Trap 
number - 

Status Trap 
number 


: 
gle 
oF 

a 


STRPHD 0A/04 Trap 
number 
SSETSW 0B/01 Value 
switch word 


Status Address 
trap 


V20-804d0 
6 L/L 
L 


Value 
Switch word 
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Table B-1 (cont). Macro Calls, Function Codes, and Register Contents 


Contents Before Execution Contents Returned 


Ca a eA NC ae 


Task Group Control Functions (cont.) 
SAaBGRO 0D/07 oe Abort Status |Group 
| id 
0D/08 Group Status j|Group 
id id 


0D/09 Group Status {Group 
id id 


Macro Call 


code 


eoyee | aod ep 


| scusre OD/0E New Status 
user-id 


Batch Functions 


SROBAT 0/00 Address {Status 
argument 
list 
= Address fixed 
ee block 


Error Handling Function 


= Component error code 
= Expansion text address 


File Management Functions 


SASFIL 10/10 Address |/Status 
argument 
| structure 


Contents Before Execution Contents Returned 


macro cat} mi] rz | ref er toe toe fen feet te toe foe fins a 


File Management Functions (cont.) 


SDSFIL 10/15 Address) |/Status 

argument 
structure 

SGTFIL 10/20 Address /||Status 
argument 
structure 


SRMFIL 10/25 Address Status 
argument 
structure 
SCRFIL 10/30 Status 
argument 
structure 
SRLFIL 10/35 Status 
argument 
tw structure 
| 
oad _ SRNFIL 10/40 Address ||Status 
oO argument 
structure 
SSTTY 10/45 Address’ |jStatus 
argument 
structure 
SOPFIL 10/50, Address |/Status 
10/51 FIB 
SSWFIL 10/5A Address {|jStatus Address 
| FIB FIB 
SCLFIL . Address ||Status 
FIB 
SGIFIL 10/60 Address 
argument 
Q ~) structure 
WN, 
Oo ~ STIFIL 10/62 
CO oO 
{ 
» | 


Contents Before Execution Contents Returned 


necro cau] mi | 2 | re fw? | foe fst drs S| wf wees ose | 
a i Ne ee ee 


File Management Functions (cont) 


‘SWIFIL 10/64 Address [Status 
argument 
structure 

‘ SWOF IL 10/65 Address [Status 
argument 
structure] 

Address [Status 
argument 
structure] 
es fot | a td fs 
Address istatus 
receiving 
field 
Address Status 
argument 
structure 

Status 
argument 
structure 
Address | 
argument | 
structure f 


Address Status 
FIB 


Address Status 
FIB 


Address pe 
FIB 
Address Status 
FIB 


Tt-d 

: 

ye) 
a 


Address 


i 
i 


Data Management Functions 


11/30, 
11/31 
11/40, 
11/41 


W20-8040 
— 6L/L 
g| ¢ 

& 


ct-d 
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Table B-1 (cont). Macro Calis, Function Codes, and Register Contents 


Contents Before Execution Contents Returned 


Hacro call ee ee ee ee 


Storage Management Functions 
SRDBLK Address jetates 
FIB 


SWRBLK 12/10, Address cae 
12/11 FIB 
FIB 


Identification and Information Functions 


~ — Pf ff 
“ — | ff 


Address 
receiving 
field 


— Poff ff 


Status Address 
receiving 


Address 
receiving 


field 
SACTID 14/02 Address {|/Status 
receiving 
field 
SMODID 14/03 Status ‘Address 
receiving 
SSYSID 14/04 Status 


_ _ (if 4: 3} _ Pf tf] ff 
SBUID 14/06 Address 
_ Po] od 


receiving 


Address 
entry 
point 


SENTID 14/07 Address 


entry 
point 
name 


hmnrininn Srnanutet eoteets mth cme ghee RARE AL cohen am eA SAAR mths ores Ate eI Cra rots 


Contents Before Execution Contents Returned 


macro con] rt rz rs fe foe foe fms me rs =e fee fos fossa 


Identification and Information Functions (cont) 
Status Group 
id 


SGRPID 14/08 Address 
user id 
STINFO 14/09 Information Status Address 
code 
Operating 


SSYSAT 14/11 
system 


| identity 
(2,4 or 6) 


SGINFO 14/0A Infor- Status Infor- Address 
mation mation 
code 
e) SHDIR 14/0B Address 
| receiving 
_ 
W 
STGIN 14/0C 
receiving 
task group 
SGRPST 14/0E Group 
id 
Intergroup Message Facility Functions 
SMACPT 15/01 
block 
address 
SMINIT 15/02 Request ||Status 
block 
address 
QO~n 15/03 Status 
Wn 
Oo —] 
00 \O 
| 15/04 Request /||Status 
© block 
> request 


¥Z0-8040 
6L/L 


Contents Before Execution 


Contents Returned 


Macro Call pe [we fw fw fo for o_o fre or [oe Je _Jos_[ nj 


Intergroup Message Facility Functions (cont) 


“ Pf fp 
-_ Pf | 


Intergroup and User Terminal Functions 


Request 
block 
address 


Request /[/Status 

block 

address 

Request j/Status 

block 

address 

—— i Address 

IGRB 

sect Status 

ee 

Request |/Status Request 

block block 

address address 
fae ee es ee ee 


Request 
block 
address 


~ Communications Function | 


-S$SDL 1B/00 Channel 
number 
. or 0 


Accounting Functions | 


receiving 
area 


Record 
Address 


Status 


Record 
length 


Status 


ae 


> 
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(ee 


oo ome ewes aaa on um GED GED aeEeee Gee auuee. woe ae asses cae aes® ees a= aaewe ase aa ae eee «we eww ae ao. 


HONEYWELL INFORMATION SYSTEMS 
Technical Publications Remarks Form 


SERIES 60 (LEVEL 6) 


TITLE GCOS 6 SYSTEM SERVICE MACRO CALLS 
ADDENDUM A 


ERRORS IN PUBLICATION 


SUGGESTIONS FOR IMPROVEMENT TO PUBLICATION 


and action will be taken as required. If you require a written reply, check here [| 


Your comments will be promptly investigated by appropriate technical personnel 
and furnish complete mailing address below. 


‘FROM: NAME DATE 
TITLE 
COMPANY 
ADDRESS 


PLEASE FOLD AND TAPE— 
NOTE: U.S. Postal Service will not deliver stapled forms 


NO POSTAGE 
NECESSARY 
IF MAILED 


IN THE 
UNITED STATES 


BUSINESS REPLY MAIL 


FIRST CLASS PERMIT NO. 39531 WALTHAM, MA02154 


POSTAGE WILL BE PAID BY ADDRESSEE 


HONEYWELL INFORMATION SYSTEMS 
200 SMITH STREET 
WALTHAM, MA 02154 


ATTN: PUBLICATIONS, MS486 


TAT 


Honeywell 


eis Sle era eee | a CUT ALONG LINES ee 


SS eit he A------- ——-——---34 


aaa, eres 


nf 
In 
an 
q 
spar 
es 


FOLD ALONG LINE 


FOLD ALONG LINE 


